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MAC IN THE SHELL* by Edward Marczak 


AWK FOR Data Processing 


The Complementary Pattern Processor to sed. 

ed and awk are typically mentioned in the same sentence. 

^9 They both have their own strengths and areas where they are 
most effective. The past few columns have walked though the 
power of sed, and I hope everyone has put sed into practice. If sed 
is so great, why do we need awk? sed is a non-inieractive editor. It’s 
powerful for unstnictured data, and picking out patterns, and making 
changes in that data, awk excels at pulling, manipulating fields in 
structured data, and generating output formatted as you .specify. 
You’ll encounter both types of data as you work, and now you’ll 
have the best, and iimsi appropriate tools. How can awk help us? 




History... Again 


ntH have every one of the extensions that have shown up over 
llie years. 

What is it? 

The man page for awk says tfiut it is a “pattern-directed 
scanning and processing language." Hie first tiling to note is 
dxui it Is a 'rear programming language, with stnicture, WeVe 
seen flow control and looping in hash and .seci before. On a 
basic level, aw'k autCKXHistiucts the main l(K)p for you: it loops 
around each line of input. When it reaches iiOl', the loop is 
broken. Like my Calculus 1 professor used to drill, ""You have to 
know the njlesr ^ame goes Ibr any prtjgramming language, 
However, rather than launch into a terse tlescriptioii, let's get 
right to some examples. 

Awk me! 

i lere's an easy one: 

S awk *[print “Got « line"!' somc^file.txt 

I'his will print '‘Got a line" for each line in some_fileixt “ there’s 
that loop, 'lliis script has one action: run a print siaternent for 
each line of input. Besides mnning awk against a file, you can 
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When I took one of my very first computer 
classe.s, in 7^^'* grade or so, 1 remember the teacher 
launching into the history of computing. What?!? 
History? When are we going to sit down and start 
typing? Nowadays, I find myself launching into history 
quite LI bit as I write these columns. The benefit is that 
it frames the present so nicely. A place we ctJuldn’l be 
now without ihai history, lids is a long-winded w'ay 
of saying I'm going to describe a little hit about the 
history of awk! 

aw'k appeared in Bell Uibs Unix V7 - roughly 1977 
- and has Ix^en paii of the standard tlisiribution since. 
However, there have been a few revisions and versions 
of awk. Sometimes, these welbmeaning versions have 
extended awk a little here and there. In 1981, the 
original authors officially revised ilte language. 1 can't 
pcxssihiy cover each and every facet of non-standard awk 
veniions. Since tliis Ls MacTech, fni going to cover 
Lucent awk, version 200i02t)7, tlie version <listributed 
with OS X, 10.4. 'I'his is the version of awk desc’rilx.‘d in 
“Tlie AWK Programming Language", 1988, by Al Mio, 
Peter Weinberger, and Brian Kernighan. ([>o we see 
where the name “awk" comes from now?) Be aware ihat 
this version matches the POSIX standard of awk. It does 
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also pipe data in. Unlike ?ied, awk docs nut prim inpot by 
default. So, to emulate cat, you could simply: 

$ ‘ I print J * fioiBe_flle. txt 

or 

$ Is 1 I awk Mprintl" 

(but using this to emulate cat would l>e silly). Again, awk 
really shines when oj^eratiiig on data with a smicuire. Comma, 
tab and other delimited formats are ideal - those have obvious 
stniclure. However, with enough practice, you1l start to see 
sLruciurc in non-obvious places. 

i‘or anyone that really dug into die sed columns, awk's 
pattern matching will look very familiar: 

S Is -1 I awk */pcap/ (prliitr 

We pipe the output of 'Is 1' into awk, where awk will 
jump into action each time it finds a line with ‘pcap' on it. 
Well, we could have done that with *ls -1 ^pcap*’, right? 
Well, yes - but stay with me here. What if we didn't want 
ail of the information that comes with 'Is -1? Or, perhaps, 
if we wanted to rearrange that info? The output of Is, with 
the “4" switch, happens to be very structured. Let’s look at 
a snippet: 

drwxr-x— 5 matezak marezak J/0 JaJi iS 17:0? trip 

— I raaresak inarezak 149 Uct 10 15:17 tw.pn^ 

1 root marezak 3114 Nov 8 20:00 tsOS.pcap 

awk will refer to each of the culuiims as fields - jiisi like a 

database. The permissions column is field 1, links column is 
field 2, and so on, up to field 9, in this example, being the 
file name. If we wanied to rearrange an 'Is* listing, we 
could use this: 

$ Is 1 I awk ‘/pcap/ (print $9,$5,Sir 
craoidump.pcap 15151 -rw-r— 

dhcp.pcap 16423 ■rw-r- 

Kkypecatch.pcap 43421 rw r— 

ssldump.pcap 260/0 rw r- 

tes td amp. pcap 12716 rwt— 
tsnow.pcap 391174 rw-r- 

lliis example combines pattern-matching and the field ofx'raior 
Again, the ouipui of Is is pipc^d to awk, which only acts when 
the input line matches “pcap”. However, we decide to 
selectively output only the ninth, fifth and first fields. 

Further into the Warren 

With sed, we saw that it was gcxxJ practice to create your 
script in a .separate file - esjiecially if it wa.s a partiailarly complex 
script, awk ciin do the .same using the -f switch. More 
cxinventionally, you may find long awk scnpXs written like a .shell 
st:rjpt, utilizing the ‘slie-lrang’ notation - # ! /usr/bin/awk. Just 
rememlxir to mark the script executable if you do this. 

Another important practice, as pointed out with sed, is 
to comment your scripll With awk, it turns out to be even 
more important, as you should document the expected input 


formal along with code commenrs. Any routine that relies on 
structured data is fragile. When the data isn’t perfect, it 
shatters into a million pieces. So, if youTe processing a tab- 
delimited file, you might start your script with these 
comments: 

^ thinner.awk 

# Remove un-needed data before injecting into Mailing 
databsae 

# Input: tab delimited file With layout: 

# f i rst_naiiie. laat_naDe, phone, num, Ehoe^size, e-mail, e- 
iiisil2. favorlte_color 

This way, when, three years later, the script skips working the 
way you'd expect, you can compare the input file against what 
you need. 

awk has some built-in variables lliat help you move data 
around. You've seen tlie fielcl OfKTator - $ - which, I should 
note, starts at 1. I mean, the first field is actually numbered “F. 
What happened to programmers counting from zero? The field 
$0 refers to the entire line of input. A useful built-in that goes 
along with the field otieralors is NF, 

NF reference) the niimlx^r of fields on the airrent line. A side- 
effect is that NF will always refer to the last field (or, 'column’). We 
('ould rewrite the file listing example atxwe like this: 

Is 1 I awk */pcap/ (print $NFJ5.$ir 

Another important built-in is FS - Field separator. Let's look 
at a very practical OS X use (or awk - hut well need to combine 
a few concepts to get there. By tlefauli, FS is set to a space 
character. As lines come into awk for processing, it splits up 
fields by siring. Unfortunately, this means that a record reading 
**Name: Catlierine O’Hara” is three fields, nor two (of course, it’s 
even worse for “James T. Kirk"). Ycju cun leave FS alone, 
making awk .split Irased on a .space charatler. You can also set 
FS to l5e any other single character, such zs a comma - 
obviously useful for a CSV file. Finally, you can use a regexp 
and match multiple characters as a separator. 

In addition to pattern matching to find data to proceas, awk 
supports two structures that allow for setup and tear-down (aka 
pre-pnxe.ssing and post-processing). The BEGIN structure runs 
iK'fore any lines are read in. This is ideal for setting variable 
states before diving in. ilie END strudure nms after all input Is 
processed, and is naturally useful for siunniing things up. 
BEGIN is a jTerfect place to .set FS, although FS can even l->e 
changed while the .script is running, 

.So, you're nmning OS X Server, and want to know^ who's 
logged on via AFR awk to the rescue! Run this: 

sjerveradmin comutanti ^^fp:coalll3dnd = get Connected Users [ avk 
‘BEGIN IPS - --“I /naaie/ [ print $NF F 

The output of server admin is fed to awk, wliich seis FS to the 
equal sign in a BEGIN structure. Ttiis simply splits the line in 
two, based on the input. Tlien wc go on to look for *name' 
records, and print out the Iasi field using NF. Let's say that you 
just wanted to find out if one particular user is connected, awk 
will lei you test a field for a match witli die tilde o[X"rator 
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So, if weVt! only inLcresicd in finding out if ‘"jane" was 
connected via nfp, we can easily do this: 

SGrversdmin rom(Mnd afpicoTnmiinfi ^ ^etConnectsdlJBerfl | awk 
"REGTN IFS = “=■*[ $2 /jane/ I print "Jane is connected I" 

1 ’ 

Of eoLirse, yon c’an match any regular expression this way. (didn't 
1 leil you learning regexp would lei you aile the universe?) You 
can invert the tilde match with an exclamation point: 

aiifk $2 H /bartel/ | print “Not a barrel^* I 

La Regie du Jeu 

I mentioned some ailes earlier What are they, and how dexts 
tliat lielj> us? Like scxl, awk [processes input in a very sjiecilic way. 

By default, each incoming iine is broken into fields, 
separated by a space, lines ("records") are separated by a 
newline. An awk script is a set of pattern matching rules and 
actions* with die formal; 

pjittern lactionj 

Patterns can be one of: 


A regular expres-sion 
A relational expression 
BEGIN 
END 

A pattern range. 


Tile BEGIN pattern runs its action before tlie first line of input 
LS read. Tlie END pattern runs its action after the last line of 
input is read and acted upon. 

Some other rules alxiuL prtx:essing: A missing action 
defaults to "print”. A missing pattern always matches. Program 
lines are terminated by a semicolon or newline. Comments 
begin with and are not treated as siaLemenLs. Comments do 
not need to sUut at coluiim and will continue until a newline 
Ls reached 

ff you're thinking, “Hey! awk is pretty powerful and 
simple!” you’d be right. Like many Unix utilities it focuses on 
one thing, and does it really, really well. In some ways, it’s only 
as complex as you make it. Of course, IVe only laid out a 
fraction of awk's abilities. One more before 1 leave cdl 

Variables and Equations 

Like every progranmiing language, awk supports 
variables, and operations on those variables. Variables are 
case sensitive, but do not, need to be declared or initialised 
Like PHP, tliis allows variables to be loosely typed, and awk 
will choose the context automatically. The following 
examples do wliat you'd expect: 

X “ 7 
y = x+3 

a = "Hello, world" 

2 ^ $1 # assign the first field to z 

print "z * “ z 

prinL "a contains ** a 

print "x = " X 
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Freny straight-forward. Variables can be used in the 
pattern portion of a rule. How about a short example? 

BEGIN t FS=”:”; x=0 1 

$2 ~ /Miguel/ I X = X + 1 t 

END ( print "^Miguel appears " x “ times in the 
data. ■' 1 

This fictitious example adds one to “x” for every time 
that the xSecond field rriatchcs /Miguel/. If I claim that 
variables don't need to be initialized, why did I in this 
example? Because the auto-typing can sometimes trip 
you up. If “x” is nol initialized, and tliere are no 
matches, awk assumes that, due to the context, that 
is a string, lliis results in the message, “Miguel 
appears times in the data.^ And tliat's just not very 
friendly, is it? 

In Summary... 

Glad 1 didn't tiy to rush awk into last month's 
cc^lunin. The more that you use both sed and awk, ihe 
more you see patterns in data, and lend to go back to 
these utilities. Despite being created in a time when 
personal computers Cor even larger systems) didn’t 
have their own SQL server running locally, or a 
powerful spreadsheet program at their disposal, sed 
and awk still have tremendous usefulness. Next 


month, Fm going to round out a little more about awk, 
and tie it into OS X. 

Speaking of last montlrs column, I missed it then, 
but now realize that it marked “Mac in the ShelLs’’ one- 
year anniversary! f need to thank David Sobsey, Neil 
Ticktin, and everyone at the magazine for getting me 
involved, spurring me along, and keeping me 
interested. Oh, and Dennis - I loved last month’s cover! 
So, 1 raise my virtual glass in toast to another great year 
of MacTech! Cheers! 

Finally, now that the dust has settled from 
MaeWorld, I do want to say it was a pleasure meeting 
with many, many MacTech readers! As always, please 
feel free to comment, suggest and ask questions. See 
you next month. 

Jill 
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Get Your Growl ON: 

Making The BIG Cat Really ROAR! 



any Mac OS X users tend to think of Open Source 
Software as “too geeky to be easily used.” After four 
years of life with Mac OS X, many Mac power users and 
IT pros alike shy away from using the command-line user interface 
(CLUI) and gravitate toward the GUI (graphical user interface), 
which is understandable, because mastering the Terminal isn’t an 
absolute necessity to get work done, or even to support others. 


Open-Source with Claws 

And so the Open Source world has adapied to 
meet Miic OS X users lialfwuy. We know because 
Apple keeps reminding us that much of the BSD 
subsystem of Mac OS X consists of Open Source 
tools» and we need look no farther than 
http://www.apple.connyopensQurce to get Apple's 
official line: 

Apple believes that using OpeiT Source 
methodology makes Mac OS X a niore 
robust, secure operating system, as its core 
components liave l^een subjected to the 
CRicible of peer review for decades. Any 
problems found with tliis software c^an be 
immediately idcnLified and fixed by Apple 
and the Open Source community. 

So what Apple seems to be telling us is that 
tlie "unsexy" parts of Mac OS X, command line 
tools like “cp’' and “cat” and '*grep’' and "netstat" 
are the nuts and holts on which other non-Open 
Souce goodies of Mac OS X like QuickTime, 
Spotlight and Expose depend. In essence, the 
Open Source pans of Mac OS X, also known as 
“Darwin"^ are supposed to be dry and boring, 
boring and geeky. A quick trip to the source 
code repository at http://www.QDen5Qurce.aDDie.CQm/ 
darwinsource dcjesn't do much to alleviate that 


predilection. Even more high-profile projects like 
QuickTime Streaming Server and Open Directory don't 
offer relief in the way of GUT tools, which, for the 
most part, are not Open Source, as they are bundled 
with Mac OS X Seiver, a commercial product. Even 
though Open Source super-projects like Fink 
( http://fink.sourceforQe.net ) and DarwinPorts 

( http://darwinports.opendarwin.Qra ) can help us manage 
the CLUI complexities, and even provide us with 
comfortahle GUIs to do so, it’.s a pretty safe bet to 
make the sweeping statement that the vast majority of 
Applets involvement in Open Source (I'm not going to 
count Safari since ills an application, not an OS 
component) exists within the realm of source code, 
GCC (the GNU Compiler Col lection)» and the GLTJT. 
Likewi.se it is underslood that most of the elements 
making up the ""look and feeU of Mac OS X (or the 
“eye candy" as some like to call it) exist in the realm 
of Apple's trade secrets and intellectual property. 

Five years ago, when Mac OS X was in Fubiic 
Beta, UNIX geeks were busy organizing and finding 
ways to get la mix and BSD software packages to run 
on Apple's new fusit>n <jf sleek GUI and Open Source. 
Much of the effort revolved around getting XI1, the 
standard Liniix/UNIX windowing system, running on 
Mac OS X. XII was abt>ul as different from Mac OS X 
as Microsoft Windows Explorer, with a multitude of 
themes and desktop managers. Fortunately, Apf)le 
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rele;ised its own disiribution of an XI1 desktofi 
manager optimised for Mac OS X in 2002, i>ringing XI1 
Open Source program much closer to whiii the lyptcal 
end-user would consider '‘usability/ 

“Make it Mac” 

XII, though, with its own keyboard shoriciits that 
use ilic control key instead of the standard command 
key, its menus pinned to tlie top of each windtjw (like 
Microsoft Windows) railier than a menu bar at die top 
of tfie screen, and its !nai>i]ity to master some basic 
GUI tricks like exchanging clipboard data with Carbon, 
Cocoa and Classic applications, liasn't found the 
ft>1 lowing we Open Source advocates had htiped fcir. 
The "big kahuna” of Open Source, OpenOITice, ran 
well under Mac OS X, but its usability (w'hat some 
wtnikl call use fulness) suffered from being an XJll 
progranu In mid-2005, the NeoOffice project 
( http://www.neooffice.org ) finished its amazing 
NeoOffice/J port of OpenOffice, bringing a pt>lished 
Open Source alternative to Microsofi Office that nins 
on Mac OS X without XIU <;)ther Open Source 
projects, such as Abiword and GTMP can now run in 
Mae OS X without the l>enefit of X windows. Whereas 
such portability seemed like a distant pipe dream five 
years ago, each Open Source XT 1 application that can 
function independently in Mac OS X brings us closer 
and closer to a roadmap for all of the best Linux and 
UNIX softw^are to find iis w'ay onto the Desktops of 
end users and power users alike. 

Made For Mac 

OK, so Open Source is geeky, boring and clunky, 
though occasionally, with a Herculean effort (the 
NeoOffice/J project being a prime example), can bear 
fruit tliai l)lossoms into something all Mae OS X users 
can enjoy. Many projects, like so many of the 
grotipwares (Zimbra collaboration suite being the 
latest darling) rliar everyone hopes and wishes might 
challenge Microsoft Rxchange in the Enterprise, may 
be diamonds in the rough, waiting to be polished a 
little. But once in a while, seemingly out of the blue, 
comes an Open Source project so useful and 
straightforward and clever that it verges on necessity. 
And when that Open Source project is something buiit 
for Mac OS X, it can he a thing of beauty. The Cfrowl 
project, w^hich lives at http://qrowl.mfo is, in this writer's 
opinion, the perfect example of such a pnjject. Growl 
simply roars: install me, I'm usefitl. 



Figure I. Growl Download Page. 

It*s difficult to classify Growl, which is often a clue 
tliat an Open Source project is either a completely new 
way of looking at human interaction wkh computers or Is 
something that defies categories because of its genius. An 
example of the former is. The Humane Interface 
( http://rchi.raskincenter.Qrg >. the brainchild of the recently 
deceased and legendary Jef Raskin, founder of the original 
Macintosh project at Apple, which may cross into the 
latter categt^ry in time. While tlie Growl project is an 
example of sometliing l>orn squarely into the latter: 
something that defies classification and is simultaneously 
useful to many people. Before delving into an Open 
Source project, it's always a g<K>d practice to see how die 
developers see themselves, and the main points of tlieir 
self-description are positively short and pithy: 

First, a bit of marketing: 

"^f/sefui nottficatiom that ytm contrtir 

Tlien, the crux: 

"Growl is a nolijleciiion system for Mac OS X: it 
allows a/iplicatkms that support Grtm/l send }fou 
noti/katlomf 

Then, the window dre^^ssing: 

"What are notifications.^ 

Growl includes seimrai display types for notificulions. 

NoHficatkms are a way for jmur applications to 
proutde yim with new information, ufithout you having 
io swiich from the application }fou're already in!* 

Doesn't seem like a whole heck of a lot on first read. 
But the key really is in the last bit: “. . .without you having 
to switch from the applic:ation you Ye already in.” 
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Nonplussed 

Nonplussed is one of my new favorite words. I iliink it's 
a more elegant way of Sitying something is so surprisingly 
wetik that I sit there with a ltK)k of confusion and surprise 
on my face when beholding the phenomenon for live Qrsi 
time Such are my feelings regarding the wimpy way the 
notification .system in Mac OS X tries to get someone's 
attention: it tells tlie application to Jump up and dfmm. 
When hnouglit to tlie front, the applit:atitm displays the 
pending ntxification. ^Hiat’s not a lerribie idea, but it can be 
easy to miss, and gives Uie user alisoliitely no idea whetlier 
the notiheition Is urgent or simply something to dismiss and 
keep working. Either way, it results in an interruption and 
requires interaaif>n on the part of Uie user 

In a similar vein, there’s m) e;isy way to liave 
notificirtioas iraveise the CLLH liarrier and apiiear in the 
Finder, ihougli it’s mn so difficulL wiili a trick or two. Yet the 
Finder's icon jumping up and down in tlie d(x:k isn't a roally 
g(Kxl way of, let's say, txfjX)rting that a scripted Irackup lias 
completed or a cron fr>b that checks l!ie status of a KAlf) 
mirror li;ts found a prol)lein. 'Ihings that are ainning as 
system prxx'esscs or command-line tasks, need to report what 
they do ils well. Since they aren't piin of tire GUI w'orld, they 
are left without the type of nouficatroas tiiey deserve, tht>se 
tliat would report infonnation in a non-inieractive way 
without having to switch Ix^tween applinuions. 

Howl for Growl 

That's precisely the void Growl aims to fill in Mac OS 
X. Growl delivers non-invasive, semi-transpariml 
notifkations that overlay the Desktop regardless of which 
application is in the foreground or background, along 
with a notification title, application icon, and pitfiy 
me.ssage. Years ago, when I was a kid at summer ramp, 
we used to do this silly thing, potintling our fists on the 
talilc, chanting ‘‘I scream, you scream, we all scream for 
ice cTeam." Now, ifs time for all Mac users to rise up, 
pound tlieir fists on their desks and ciemand from their IT 
staff: ‘T howl, you howl, we all howl to get Growl." 

» 0 .- Growl I cJ 

7 iwm. MB AvdJUMi 


* 1 !' 



Figure 2. Mounted Growl Disk Image. 


Getting Growl is pretty easy. Just download the 
installer from http://grQwl.infQ and double-click on ilie 
Growl.prefpanc. When asked, decide whether you'd like 
to install Gmwl for yourself or kn all users of the 
computer. For all users, you'll need an admin username 
and password. Even though it's not necessary to i>e an 
atlrnin user to install Growl, admin rights are necessary in 
order to use it as a scripting eniiancement, if ifs necessary 
to am script with rexH privileges, so i recommend 
installing it for all users of the computer 


The ■'CrowF preference pane must be insutled before 
VDU tan use \t Do you want to install it now? 

O Install for this user onlv 
@ Install for all users of this computer 

When YOU click IniuH. you'll be asked to enter the lume and 
oassword for an administrator on this computer, 

(Cancel ^ Insiall ) 


Figure 3, Install for One or All Users 


Once insltiJk^, the Growl preference pane reveals a 
numix^r of options, sucli as the notification style, tlie 
applications rcgisiered to use Growl, and wliich 
noiificaLions llicy're set to u.se, iis well as a "Stop/Start” 
Growl item, that either latmches or kills the 
Growl HelperApp ljackgn>und proc'ess. 'Ibe styles range 
from the default ‘'Bubbles" to the more serix>us-looking 
"Bezel” and the mtlier in-your-face “Music Video” wliich 
places a long black Ixir across lire bottom of the display 
right where the Dock usually sits. G^enerai Growl 
preferences govern the Growl background proce-ss 
GrowlHeiperApp, wlieilRT logging Is enabled or not, idle 
and menu bar statu.s icon settings, and whether Growl 
six HI Id automatically check for update.s. 



Figure 4. Growl General Settings. Figure 5. Growl 
Application and Notification Settings. 
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And record all your conversations. And play them back. And a whole lot more. 



0 VO lab Phi ink is the ultimate message 
center for your Mac. It answers phone 
calls and identifies callers using Caller ID 
and Apple's Address Book. It greets your 
friends with personalized messages. It 
records and stores messages on your 
computer - and even forwards voicemail 
to email as AAC audio anachments. 
Featuring multiple voice mailboxes, 
high quality audio, Spotlight searching 
and fax capabilities, Ovolab Phi ink makes 


your telephone part of the digital hub! 
And you can fully customize Ovolab 
Phi ink to do exactly what you need, 
using AppleScript: even set it up to call 
you back on your cell phone when 
important clients leave a message. 

Check it out now at www.ovQlab.com. 
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'rhe next tab in the Growl preference pkinG governs 
the Growl-savvy applications registered with the Growl 
notification system and their notifications, which can be 
toggled between a state of on and off, and whether they 
are “sticky” meaning thar they will stay on screen until 
receiving a mouse click. Individual display styles are 
available for each notification, as well as a priority, 
should there be several notifications queued. One of my 
absolute favorite Open-Source programs for Mac OS X, 
is Cyberduck Chttp://cyberduck.ch), a wonderful 
FTP/STFl^ diem, made "just for Mac OS X.,” For long 
downloads and uploads, it's very useful to have some 
notification.s more informative than a “jumping” duck, 
and witli the “sticky” option, the notice remains on the 
screen until receiving a mouse click. 

It’s not hard imagine t\%il 
useful noiiric*itions siidi as thtxse 
from Cylx^ixluck would find their 
way into so many devdo[>ei:s' 
applicatioas. Growl even ha.s 
rec:cnlly-added network siipp(>r(, 
which alkws for the n-‘laying of 
alens to diem machines acrass a 
network, Ifs even ix>ssihle to .set 
up multiple relays to prt>j>ag-ate 
notifiatrions over a wide area 
network, tltotigh netw^ork 
implemeniatioas of Growl are largely unheard of at this fxjint 
in time. For System Administmiors whod like to send Grow-l 
notificiitic^ns over a neavork, tliere's the Growl Perl Module 
in CPAN (Comprehensive Perl Archive Netw'orkj 
httD://search.cpan.QrQ/ -nmcfarl/Net-Growl-Q.99/lib/Net/GrQw[.Dm that 

cm .scmtl f)UL Growl nocifiattioas uithrmt Gn>wl needing to 
lx: installed on tlie originaiing host. 0|x:njng up the tl(K)r to 
mxificitioas that migiu ctnne from a Linux at Windows lx)x 
as well. As a matter of fact, with somt* tTtx>peration, it’s not a 
stretch to itmigine Growl and a network mtJnitcjr like Nagios 
( httD://www.naaiQS.orQ) complementing each other to fonii a 
compa*hensive st^lution for kx':il and neinoie aleris vut web 
serv^CT, pager, email ^md the Deskto[>, 

Growl, Who’s There? 

Perhaps the most common use for Growl is an 
application w'hicli many Mac users depend on fc^r daily 
interaction and communication, yet suffer from the 
“jumping” icon syndrome- iCIial. As people on an iChal 
buddy list come online or go offline, ilie user gets 
background sound effects. If a chat is initiated, and iChat 
is in the background, iChat jumps, it doesn't say who is 
inviting you to chat nor will ii tell you who is available, 
or who would like your attention. Wouldn’t it be nice if 
ii did? Wouldn't it be nice to see the incoming status 
messages from a backgrounded chat session witlKRit 
brining iChat U> die front? Wouldn't it be nice to know^ 



Figure 6. Upload Task 
Completion Notification. 


exactly who is available or not available with a 
translucent status message rather than a ufhoosh sound 
effect, ihai says “someone is either cxHtiing or going, I 
dan'i know who. . .” Well, that's precisely what the free 
enhancement growliChat ( http://www.growlIChat xom ) 
brings to Mac OS X. Installing gniwliChat is a piece of 
cake, just download it and double click on the disk 
image (.dmg), then douhle-click the pretVane to install it 
and move the application to /Applications. 



Figure 7. Installing GrowliCKat. 

Once installed, and with growliChat ninning, it’s 
necess;jry to specify the desiied notification fyeliavior. The 
default is usually good enough, though its possible to turn 
noiijlcations on or off for sjK-dhe buddies. Like Growl, 
growliChat Ls configured via a preference pane, with a few 
tails of' options for each iiTijcR form of iChal tras[>ait: AIM, 
bonjour, and jablxT, nriking it a suiuible enhancemeni for 
the new iChar service: bundled with Mac OS X Tiger Server. 



Figure 8. GrowliChat AIM Notification Settings. 

Once ever>ihing’s configured accordingly, and 
gnowliCliiii is running and registered watli Growl, die hin 
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Innovations by InterSystems 




Compfisiu Application Developmcnty plus... 




Business Activity Monitoring 


Integrate Your Enterprise. 

Ensembie Enables EAI, BAM, BPM, 

And All That Jazz. 

Ensemble is the fim product that enables fast iiUegration and rapid developmenr. This unique 
platform combines the capabilities of aji iiuegraiion server, data server, application server, and 
portal development soft^'arc. 

What makes this possible is an innovation by InterSystems: We developed Ensemble as a single 
technology stack, not a stitched-together suite of separate components. With a unified environment 
for integration, development, and management. Ensemble dramatically reduces timc-to-solution. 

We back these claims witli tliis money-back guarantee: hor up to one year afhryou purchase 
Ensemble^ if you are unhappy for any reasonj we^ll refund 100% of your license fee. * We are 
InterSystems, a global software company with a track record of innovation for more tlian 25 years. 

InterSystems 

mm 

Kctpicst a FREE proof-aficoncept project at www.liTterSysteins,cooi/Eiisemblcl 2 HH 
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Ix^gin.s! Now, imteacl of the wiMHisb sound when a buddy 
comes online, and having Lo bring iClial to the foregrcjund to 
.see who may have l>econie avaiLible or away, the user’s 
gnjeled witli the tbllowiiig notification: 

; .. .. . . ... . 

i allenhancock^imaccom 

j is available 


Figure 9. GrowliChat Buddy Available Notification 

J can’t liegin to gush t>ver liow useful this is compared 
to a whoash sound. The notification presents the 
screenname, first name, or full name of lire fiuddy 
changing status, the status (available) and even a picture 
(or icon) of the buddy as if the name weren't enough! 
Sinc:e \ installed growliChat, 1 no longer find myself 
bringing my buddy list window to the froni to check out 
who's left or arrived. So pcmeiful and yet so simple. Kind 
of like I he spirit of the Macimosh itself. 

F ^ 

|E^| aMenhancock@)maccom 
went offlilie 

Figure 10. GrowliChat Buddy Offline Notification. 

If You Build It, They Will C.ome 

One of the classic mylhicat ways to make a fortune 
is to “build a heller mousetrap.” ’fhat w'hole notion is 
predicated on ihe fact, ihat. ever>’'one has a problem 
with mice, which Apple has now' seemed to address 
with the addirion of the Mighty Mouse to its product 
lineup. But in ihe Mac OS X world, people have an issue 
wdth application notifications, even if iliey don’t realize 
it. Others have called CptowI an enabler with "multiplier” 
capabilities that could possibly enrich the eniire Mac OS 
X Software landscape. Today, aboui ISO apjtlications in 
13 categories spon Growl support, from Pow'ermail 
( http://ctmdev.com/ ) to the Sliiira Web Browser ( http://hmdb 
web.net/shiifa ), that shares the Wehkit engine with 
Apple's own Safari to the FIT Clients Cyberduck and 
Transmit (lui()://panic.com/transmii), Personally, 1 can'i 
imagine any developer working on an application that 
benefited from notifications not considering using 
Grow'l suppon. It just doesn't make sense to roll your 
own. Hear that. Ruxio? 

When faced with the task of notifying users of my 
own application, Mac llelpMate, 

{ http://www.macwQrkshops.CQm/macheiDm3te ). that a 
scheduled maintenance task had completed, I wasn't 
very thrilled wiih having a dialog pop up in the Finder, 
to trigger a leaping Finder icon in the dock, forcing the 
user to bring the Finder to the front to get the message. 
Does that sound like a repetitive and familiar 
complaint? Sure! So, T decided that, if a Mac HelpMate 


user wanted lo install Growl, then Fcl support Growl 
for the notifications instead. 

■i 

Scheduled tasks completed! 

Your Mac may reboot! 

---- . 

Figure 11. Mac HelpMate Scheduled Task 
Completion. 

installing Growl also installs the Growl.Fiamework for 
C(x:oa Develoi^ers in /Library/Frameworks. However, since 
I’m not a Cocoa developer {AJthoiigli I aspiic Lo Ik- at some 
point in the fiitiire, for now Mac HelpMate is an AppleScript 
Studio effort), 1 needed a way to hook up with Growl 
notifications ratlier than by using Objective C. Fortunately 
lor me, Growl has some rather eiisily accessed support tor 
AppleScript. All it takes is a little umginaiion to add fancy 
noiifications to even tlie simple.st of applications. 

Hear that, Apple? 'I'here'.s even a certain crowd of 
independent developers and their as.stxriates wlio w'ould 
advocate Apf>le adopting Growl or choosing to bundle it 
with Mac OS X. Although Apple has its own translucent 
bezel notifications, the most conspicuous of which, are 
the translucent “eject'' icon or “volume" icons, that appear 
over the Desktop, there’s not a readily available 
Framework available for Developers to use. Even though 
Apple has a track record of imitating popular eye-catching 
technologie.s sucli as Watson (for Sherlock) then 
Ktmfubulator for Dashboard, Growl ha.s already gained so 
much momentum and is complex enough (network 
suppon is a perfect example) that Apple w'ould be hard 
pressed lo clone, bundle or support Gnf>wl for the typical 
Mac OS X user. For that rea.son, my money is on Growl 
remaining a growlingly popular application most Mac 
users W'ill never know al>out (sniffle), unless we, Uieir 
System Administrators, Suppon Prtj.s and Consultants, 
give It to them. 

If You Build It, You On Growl 

Those of you who read my column certainly are familiar 
with ilie biu anti bltirlt I use to cIosl: oui each one, but this 
time, I want to do ii a different w^ay. This time, I'm going to 
sign oF using a Giewl notification. Let's start with a .simple 
AppleScript appliaition designed to do two tilings: first, 
register itself as a Growl application, sexund, actually send a 
notification from tlie application tc3 the f>esktop via tlie 
Grow'lFJelpA[3p process, fm going lu use the .sajnple 
ApplesScri]>t ccxle frcim the Growl site available at 
http://arQwl.infQ/dQcumentation/applescript-suppQrt.php llie simple 
AppleStrripl application is going to be called "Amhorljio." 

Step 1: open up ihe “Script Editor” application in 
/Applicalions/AppleScript and copy and paste the 
sample AppleScript code into the new' script w'indow' 
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Step 2: modify the AppleScript with your desired 
Application name* and your desired notifications 


Step 3’ use the very cck)! Open Source utility imgZicns 
frt)m vwwaknet.it/progratTi/img2tcns to create a tbkler thim 
a piaiire of yourself and then cut and past the icDu on 
to your Application when your finished* like so; 


▼ Previ«iAr 


Step 4. Save the AppleScript as 
an ApplicaLitm, and cut and 
paste the icon of yourself (>n 
the Authorbio Applicralion so 
that when you "sign out” using 
the Growl notification of your 
choice, your face is showing 
next to the alert— 


MAmc AuThorbio 
Kind Apiaication 

IzaKfiondisk 
0«Ateil 2/S706 11:27 
Modified Today at 6:12 PM 
La^t opened 
Arc Hi tent u re PowerPC 

More info... 

Figure 12. Custom Icon 
from Photograph. 


Step 5: After initially registering 
the Application in the Growl 
preference [Dane in System 
Preferences, make sure youVe 
.selected an alert style t:apable 
of displaying a lot of text. For 
my own puri>oses, I prefer the 
"smoke" style. 



Figure 13. Select Appropriate Alert Style. 

Here's the AppleScript code of my Authorbio.app 
Application. You can download the entire project from 
my site, http://www,themacheldesk.corD and customize it 
for your own use. There's even an example on how to 
use osascript to mn the notification from ihe Terminal, 
so you can use it io notify you when cron jobs or 
launchd jobs complete! 

-presenf the choice in a dialog: 
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Looking for a great selection of cables? 

MacTech has selected a quality vendor, with qualify 
products for your coble needs. Benefits include: 

• Lifetime warronty on cables 

• Same day shipping if you order by 4 PM ET 

• Express shipping orders can be ordered up to 
6:30 PM ET for some doy shipping 

• Huge selection - 3500+ items and growing 

Check out the full selection at the MacTech Coble Store 


http://www.mactech.com/cables 

































Complete Soune Control 

cbaiiKt^Ibtr world 

and Defect Management 

for Mat OS X 



Effective source code control and defect tracking require powerful/ 
flexible, and easy-to-use tools—Surround SCM and TestTrack Pro 


Complete source code control witfi pnvate 
workspaces, automatic merging, role-based 
security, and more 

Comprehensive defect management ™- track 
bug reports and change requests, define workflow^ 
customize fields 

New! Full Unicode support maintains international 
characters across various languages, ensuring 
data is not lost or misinterpreted 


• Advanced branching simplifies managing multiple 
versions of your products 

• Fast and secure remote access to your source 
files and defects work from anywhere 

• Scalable and reliable cross-platform, client/server 
solulions support Mac OS X, Windows, Linux, and Solaris 

• Exchange data using XML and ODBC, extend and 
automate with SOAP support 

• Licenses priced to fit your budget 




Seapine Software Product Lifecycle Management 
Award winning, easy-to-use software development tools 


Surround 5014 


Seajiiiii* 


TestTrwk 

PRO 

d pcoduct tidim lisicd km acQ imdemork^ ot Ihpiirj&spedivis awniis. All ligftls 


Download Surround SCM 
and TestTrack Pro at 
www.seapine,com/mac 
or call 1-888 683-6456 
































Figure 14. Authorbio.app User Interface. 


for this script's notifications, 
register as application 

•^Authorbio" all notifications 
iNotlflcationsList default notifications ^ 

enabledNotlflcationsList icon of application 
"Authorbio" 
end tell 

--if "sign off" then say goodbye to this issiie of 
MacTsch 


set mygrowl to display dialog 

"VThat do you want to do?'^ buttons ["Register"* 
"Sign Off"! 
default button 2 

set grrr to button returned of mygrowl 

--if "register" set up notitications and register 
with Growl 

if the grrr is equal to "register" then 
tell application "GrowlHelperApp" 

- * Make a list of all the notification types 
-- that this script will ever send: 

set the alXNotlflcatlonsLisi to 

("Scheduled tasks completed!"* "Dean Shavit"* 

—t 

"S,M*A.R.T Error Detected! Backup up your 
data ASAPl"f 

** Make a list of the notifications 
-- that will be enabled by default. 

Those not enabled by default can be enabled 

later 

** in the 'Applications^ tab of the growl 
prefpane, 

set the enabledMotlficatlonsiist to -> 

("Scheduled tasks completed!", "Dean Shavit". 

"S.M.A.R.T Error Detected I Backup up your 
data ASAP!"} 

-- Register our script with growl, 

- - You can optionally {as here) set a default 

icon 



else if grrr is equal to “^Sign Off" then 
tell application "GrowlHelperApp" 

Send a Notification,., 
notify with name "Dean Shavit" title "Dean 
Shavit* a.k.a Sourcehound" description "is an ACSA 
(Apple Certified System Administrator) who loves 
Open-Source and freeware solutions for Mac OS X. 
During the day* he is a partner at MOST Training & 
Consulting in Chicago, where he trains system 
administrators in Mac OS X and Mac OS X Server* 
helping his customers get the best SOI possible 
from their computet Investment while writing for 
his own website, www,thcMachelpdesk.com* Recently, 
he became the father of an application: the Mac 
HelpMate troubleshooting tool* available at 
www.Kachelpmate*com. If you have questions or 
CDraments you can contact him: 

dean@Macworkshops.com" application name "Authorbio" 
with sticky 
end tell 
end if 


OK* let's mn the AppUcarion. First, well need to 
choose to register the application st) it shows up its a 
“known” alerting process in die Growl System Preference, 
Launcii tiie Audiorbio, and click the “register” button: 


Application re-registered 
Authorbio registered 


Figure 1S. Application Registration 

Now, let’s try it again* except tills time, i'll click the “Sign 
off Button*" and make my grand exit. I'm uasure wliat Fm 
going to v^Tite ab<.)uL in my next column, but tliis is such an 
exciting time to lye a Mac user, the wY>rkFs a veritable oyster. 
So, my good friends, ciao for now. , * Signing off, . 

'I’iii 



P|P| Dean Shavlt« a*k*a Sourcetiound 

,. , is an ACSA (Apple Certified System 

Administrator) who loves OpenrSdufce 
and freeware solutions for Si^ac OS X. 
During the dav» he is a partner at 
MOST Training & Consulting in 
Chicago, where he trains system 
administrators in Mac OS X and Mac 
OS X Server, helping his customers get 
the best ROI possible from their 
computer investment while writing for 
his own website, 

www theMachelpdesk.com. Recently, 
he became the father of an 
application: the Mac HelpMate 
troubleshooting tool, available at 
www.Machelpmate.com. If you have 
questions or comments you can 

S . conraa him: 

dean@Macworkshops.com. 
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Intego VirusBarrier X4 

The acclaimed antivirus program for the Mac 



The change in color of the Orb 
Indicates the presence of an 
infected or damaged file 


Choose the data to be scanned 
in the dialog box with a simple 
click* 


Schedule regular or specific 
starts of your volumes and 
view them in Apple's iCai 


k- s ■ 

Decide for yogrseff the best 
level of security for your files 



© © o 


Automaticaliy or manually check 
the availability of updates or 
virus definitions. 


Display all analysis logs of your 
volumes and files with a single 


Scan 



Last scan starteil on Monday, October 10, 




^ - 5 - 

_ I Turbo Mode technology analyzes 

^ you r data up to 40 ti mes faste r. 




Discover, under Tiger, new Intego Widgets 
informing you of the status of your protection, 
the ava ila bi] ity of updates, an d sch ed u led 
events. 


and folders* 


Protects 

against the 

Oompal-o»jnP» 

(OSX/Oomp-ft 

or Leap^i 


. ” ■ ■ ■ -T 7 i" ., I _ L '. i 


VirusBarrier X4 alerts you to the presence 
of viruses and repairs damaged or corrupted 
files. 


- -IE:- V ‘ 

Easlly schedule, ch^ck and Install new 
virus definitions and updates for all Intego 
software Installed on your Mac. 


Date 


Status 


^ lO/lO/OS 1S;06:0S Wnzipped-Text.Data.pif Is infected by 'WSZ.Sobef.PV 
O 10/10/OS IS:06:OS VoiumePnotecitonSegmentLink.b’ is corrupted. 

^ 10/10/05 15:06:01 ‘Macro.Word97.Vovin.doc^ is infected by 'WM.Vovan'* 

Q 10/10/05 15:06:03 phpbb-worm.pl'is infected by 'Perl.Santy.C. 
ii lO/lO/OS 15:06:03 'openerlS.shMs infected by mopener'. 


( Clear**, ') Export,,. 3 


( Reveal in Finder } ( Repair } 



Main features of VirusBarrier X4 j 

• Deteci$ n nd eli m tnates all known viruses 

• Heutrlstic and behavioral analysis 

• Repairs Infected files 

• Blocks virus execution 

1 • Turbo Mode technology {op to AQ times fasEer) 

• New mutli-function Orb 

1 * Simple, effective and min-intrusive 

« New alert management ' 

1 * New dynamic resizable interface 

• Fi le a nalysis by the intego Virus Mon itoring Center | 

* Scans Incoming and outgoing e-mail 

* File creation and modification detection 

* New Intego menu 

• Temporary antivirus deactivation 

» VirusBarrier X4 Widget and Intego Widget 

■ Easy integration with other Intego programs ' 

• Scheduled scan$ 

* Management of compressed files 

; * Detailed log 

* Conteiduai Menu | 

' * Reinrofced security zone 

■ Updates via NetUpdate X4 , 


O Apple Store MocMall HAySHR™ fri 
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www.intego.Gom 


intego ■ 500 Norfi^ Capital of Texas Hway, Suite B-1 SO - Austin, TX 7S746 • Tel [S12) 637-0700 * Fax {512) 637-0701 * sales®! ntego.torn 



































































Mac os X Tiger for Unix Geeks 


Mac OS X Tiger 
for Unix Geeks, 

published by O'Reilly, 
is a book for Unix 
sysadmins and 

developers who are 
interested in 

discovering Mac OS 
X’s underlying Unix 
roots. The autiiors, 
Brian Jepson and 
Ernest E. Rothman, 
assume the reader has 
a solid familiarity with 
Unix fundamentals. 

Tile bcK^k is divided 
into four instructional 
parts (Getting Aiound, 
Building Applicaiions, 
Working With Packages, and Seiving and System 
ManagCTncnO and a final section devoted to two 
appendicxes (Mac OS X GUI Primer and Mac OS X's fJnix 
Development Tools). 

Part I is an intrtjduclion to Unix on Mac OS X in ten 
chapters and is so extensive that it constiaites half the 
book. Chapter 1 introduces differences between the 
Terminal app and xterm and xtermdike af^plications 
specific to systems running X Windows, how to customize 
tlie terminal, and worlcing with files and directories* 
Chapter 2 covers Spotlight and searcliing metadata from 
tile command line using mdf ind. The next chapter deals 
with file transfer issues that arise from moving data 
betw^een differeni file systems* This is a particularly 
helpful seeLic:)n on understanding the consequences of 
transferring large numters of files between foreign 
operating .systems. The auiht)r.s also list directories in 
tabular format: /, /etc, / Sys tem/Library, 

/Library, /var, and /dev* 

There are some distinct startup differences between 
traditional Unix systems and Mac OS X Tiger, detailed in 
and the boot process is detailed in Chapter 4. In fact, 
there are changes between Tiger and pre-Tiger systems 
and this chapter presents an outline of the differences and 
consequences veiy nicely. A logical consequence of this 
discussion is how to add startup items and schedule tasks 
and the authors illustrate this with a very useful MySQL 
startup script* 


Chapter 5, Directory Services, gives a brief overview 
of understanding and configuring Open Directory, and 
Mac OS X's version of Directory Services* 'There is a very 
helpful section on working with passwords and the 
authors demonstrate four Netlnfo/Dircclory Services 
utilities: dscl, nireport, nidump, and nlload. 

Printing through both the GUI and through the 
included Unix tools (CUPS and Gimp-Print) is Llie topic of 
Chapter 6. This chapter Ls well stocked with screenshots 
and is a quick read. 

Chapter 7 goes over Apple's XII implementation of 
the X Window Sysicm: installing, running full-screen or 
rootless, customizing preferences, connecting to other X 
Window systems using ssh with XI1 forw^arding, using 
osx2x to share a keyboard and mt^use between systems, 
and how to use vne* 

TTie topic in of Chapter 8 is multimedia and disaisses 
burning CDs, using the open source MPlayer for 
audio/video playback, the Gimp for image editing, and 
lilender for 3D modeling. 

In the next cliapter, die authors include third-party ttx)ls 
and applications: virtual desktop implementations, ssh GUI 
fronLends, and opcii source tyfiesetting, mathematical and 
statistical apps (TeX and R), and office suites COpenOffice 
and NeoOfilce/J)* Tlie information on TeX and R Ls 
particularly well dtxumented, due no doubt due to Dr* 
Rothman's scholarly pursuits* Fart 1 ends widi a chapter on 
dual Ixxiting various flavors of Linux (Yellow Dog, Gentcx>, 
Ubuniu, etc.) with Mac OS X, using emulators fVirtualPC) as 
well as nr lining Mac OS X on x386 machines using PearPC. 

Part II, Building Applications, is for diose developers 
and Unix/Linux power users who are comfortable with 
compiling and linking source code. There are plenty of 
subtle differences between the Unix and Mac OS X 
compilers, and Llie autiiors provide ample instruction on 
how to work with Apple's version of the GCC (GNU 
Compiler Collection), 'The authors provide a complete 
discussion of compiling source on Mae OS X and include 
frameworks, architectural issues (AltiVec, 64-bit 
computing and endianness), huilding Xll-hased apps, 
AquaTerm, and Xgrid. They go into fuither depth by 
s[lowing how to link header files (ordinary and 
precompiled) and libraries in Mac OS X. There are very 
good examples of building a shared library that contain C 
functions and dynamically loading libraries. 

Part 111 covers software packages options: Fink, 
DarwinFons and creating and insialHng your t)wn 
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JobCapture is intuitive, user-friendly client-server 
software that intelligently and automatically 
tracks working time and activity. Open a docu¬ 
ment in any application, and it is automatically 
being timed by JobCapture. This guarantees that 
all work activity is recorded. 


Perfect for ad agencies, 
design studios, architects, 
law firms, PR Firms etc. 
Scalable. Flexible. 

Easy to configure. 

Cost effective. Adding 
additional users is easy 
and inexpensive. 

Tracks time and expenses. 


Client and Server 
software is included. 
Easily customized. 
Real-time data delivery. 
Customizable reporting. 
View data numerically 
or graphically. 

Import/Export data to 
SQL, mySQL, XML etc. 


JobCapture will increase productivity and your 
bottom line by providing accurate records for 
billing and analysis. Stop losing money now — 
Call today for more information: 973.763.9494 
Reps are available 10:00am-5:30pm, EST. 


www.captureworks.com 
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packages, llTere are step-by-step details on how to install, 
setup and use Ixjlh Fink (and FinkConirnander) and 
Darw'inPoits, and using Apple's PackageMaker tools. 

Using Mac OS X as a server (secure mail, ssh, Apaclie 
web, using butk-in services through the sharing pref 
pane, 2 ind using the Mac OS X firewall), system 
management and configuration tools (top, sc_usage, 
vm_stat, sysctl, nvram, scutil, and third-party 
apps like Ctjcktaii, Macfaniior and TinkerTool), free 
databases (SQLite, MySQL, and PostgreSQL), and some 
Fed and Python extras that are included in Mac OS X are 
discussed in Part IV. 

In Fajt V, the Appendicxes, cover a basic overview of 
the Mac OS X GUI and includes a reference to a selcclitm 
of Mac OS X’s Unix devek^pment tools, 'ITie latter 
describes the similarities and differences between 
development tools available on standard Unix systems 
and Mac OS X Tiger, Also iIncluded are brief descriptions 
of Xcode tools (CpMac, HvHac, Res), Java (jar, jdb), 
text editing and processing (awk, join, sed, vim), 
scripting and shell programming (echo, perl, xargs), 
file manipulation and sorting (cat, chmod, diff, 
rmdir), and other miscellaneous tools (apropos, 
passwd, su and sudo), 

Jepson and Rothman have complied an excellent 
book for Unix u.sers wlio want to come up to spcvd on 
Mac OS X quickly and efikiently. Mac OS X Tiger for 
Unix Geeks includes all the basic information that 
experienced Unix users will need to become comfortable 
with the Mac platform, ibe authors cover a wide variety 
of practical scenarios where Unix sysadmins and 
developers can put tlieu' newfound knowledge to use. If 
yoifre comfortable with Unix and w'ant a companies 
voluiiie to help you unlock Mac OS X's Unix roots, Mac 
OS X Tiger for Unix Geeks is the book for ycm. 

^rian Jepson ik Fi nest E* Rothman"^ 

415 pages 
OKeilly 

ISBN: 0596009127 
US $34.95 


About The Author 
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Random 


Implementing Five PRNG 

Algorithms in Cocoa. 


By Jose R.C. Cruz 


Introduction 

Randtjm number?; are commonplace in the field of 
software design. They are often used in such 
applications as cryptogniphy, statistics, and simulations. 
However, the digital computer is a deterministic 
machine. It executes specific software instnKtions in a 
specific order on data usually provided by the user. 
Some high-end sy.sterns use additional hardware to 
generate random numbers. These generators use natural 
events such as radioactive decay or thermal noise as a 
source for randomness. However, most systems 
nowadays, use algorithms known as pseudo-random 
number generators (FHNG). 

'rhis article will focus on five commonly known 
PRNG algoriiiirns, A brief background on each 
algorithm will be presented, focusing on ilieir 
respective traits and limitations. Later on, a core Cocoa 
class will be proposed for implcjnenting each PRNG 
algorithm. Finally, three test algorithms will be 
presented. These algorithms are u.sed lo determine lhai 
a PRNG algorithm is generating a sialisUcally acceptable 
random sequence. 

To further assist software engineers in designing and 
implementing PRNG Ctx-oa classes, a demo applicarion 
kntiwn as DiceC is developed to accompany tins article. 
This application implements many of the ctmcepts 
presented here, both the application and the XCode 
project are available for downloading at the Mac'Lech web 
site httD://www.m3Ctech.com . 

The Pseudo-Random 
Number Generator 

Basic Concepts 

Pseudo-Ratidom Number Ceneruiars are 
algorithms used to generate number sequences that 
have the appearance of randomness* I'hey achieve this 
through the use of an iterative mathematical function 
and/or bit shifting. 


As its name implies, PRNGs are not true random 
number generators. First of all, they all require an 
initial numeric value known as a seed. The seed value 
determines the numbers that will be generated in the 
sequence. Using the same seed will always result in 
to the same random sequence. This trail, known as 
repeatability, is desirable in many applications such 
as erypLography. 

Another aspect of 1*KNG algorithms is that the 
random sequence repeats itself after X number of 
values. This trait, known as period, is a distinguishing 
factor between PRNG algorithms. A well-designed 
algorithm should have a period as dose to (if not 
greater than) the lai-gcsl possible random value, A 32- 
bit PRNG, for example, should be able to generate 
close to 2^^ random numlx,TS i>efore the sequence 
repeats itself. 

The Middle Square Method 

ITie Middle Sc|uare Method (MSM) is one of the 
earliest known PRNG algorithms devised for the digital 
computer. It was propo.sed by Dr, John von Neumann and 
ii.sed on the KNIAC ccimputcr in 1946, It is also a poor 
generator' its inclusion in this anide is mainly for 
comparative purposes. 

Figure 1 .shows the generating function used by the 
MSM algoritluii. When generating a new random numlx?r, 
tile previous number Is first st[uared. Then only those 
digits located in the relative middle of the squared result 
are retrieved as the next random value. Ihe number of 
signiFicant digits of eadi random value maidics tliose that 
comprise the seed value. 

To illustrate, if the seed has a value of 1234, first 
calculate llie square of the seed. 

1234^2 =???????? 

Tlie first random numlier would then be the [tiiddle 4 
digits of the squared result, 

mid(1522756)= 5227 
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To generate the second random num[x.T, h imply take the 
first random number and follow the same two steps as 
shown alx)vc. 

5227^2 ~ 27321529 
mld(2732l529) ” 3215 

The MSM algorithm has a number of shortcomings. 
One us that the algorithm suffers fn>ni a very short 
period of 10“^, where m is the number of signiricanl 
digits contained by the seed value. In the above 
example, the seed value only has 4 significant digits. 
This implies that the algorithm can theoretically 
generate no more than 9999 unique numbers before it 
repeats the entire sequence. 

Another shemcoming is tkic the MSM algoritiim 
sometimes implodes into a non-random sequence long 
before it reaches its maximum period. Unless it is 
prcivlded with a new seed, the algoritiim will start 
generating a small handful of single numlser values. 


R„^, = mid(/?,^,w) 

^ nfruh/rt 

/?« = pfrv/fHfS mrtUifm mmi/nr 

if# i= mifh// strt/ 

411) = m mtm/wr rtf t’.rtrut U^J 

/ront f/ie wri/tffi' 

Figure 1. The Middle Square Method. 



Figure 2. The Linear Feedback Shift Register. 


The linear Congruential Generator 

Hie Linear Congruential Generator (LCG) is one of 
the oldest and most widespread PRNG algorithms. Many 
modern operating .systems and code lil>nirics use a 
variation of Uiis algorithm as their random number 
genenitor. 

Unlike the previous rwo, the LCG algorithm uses a 
modular e<iuation (Figure 3) to generate a random 
sequence. Its overall performance is .strongly depended 
on values chosen for its generator constanLs A, B and M. 
A list of common LCG variants, and their respective 
generator constants, is ,slK>wn in Table I. 

To ensure an optiiml [Period, die following rules are 
usually followed when choosing values for the direc 
generator constants: 


The Linear Feedback Shift Register 

The Linear Feedback Shift Register (LFSR) algorithm 
uses bit taps and bit shifting to generate a randtjm 
sequence. As sliown in Figure 2, the algorithm first taps 
specific bits off a theoretical register. It then tletermines 
tlie cxld parity of the tapped bits by using an XOR 
operation. The contents of the register are shifted to the 
left by one, and the most significantn bit (msf?) replaced 
is by die computed parity bit. 

Tlic LFSR algorithm is fast, simple and reliable. It has 
a maximiim theoretical [period of 2^^^, where m is the hit 
precision of the register. Tile 32-bit example shown in 
Figure 2 has a maximum theoretical period of 2-^^, This 
implies that up to 4 294 967 values can be generated 
before the random sequence repeats itself. 

Due to its simplicity, the LFSR is often implemented 
as a hardware generator It ha,s found popular usage in 
emlx?dded sysStems such as spread-spectrum radio and 
GFS units. Non-linear variants of the LFSR algoritiim were 
also used in cryptography for generating stream ciphers. 


• Omslani A is a positii^ integer mttcb greaier i/jan /. 

• Comtants B mid M neetls to he relutiifefy //rime with 

each other, fn other words, they share no common 
factors except /. This does not irnpiy that either Bor M 
(or both) have to be prime numbers 

• The ex/}ression (A ^t) should be divisible by till /mme 

factors of M. Comec/uenlly, if M ha/}pens to a multiple 
of 4f ti/en (A — I) should also be a mutti/de of 4. 

■ The constant M sbotdd be greater than the constants A 
and B and the seed value, Rq. 

To determine if constants B and M are relatively 
prime, the algorithm known as Euclid 's Algorithm is used. 
This algorithm employs successive modular divisions to 
determine tfie greatest common denominator (GCD) 
shared by two integers. If the integers are relatively prime, 
they will have a GCL> of 1. An implementation of Euclid’s 
Algorithm a.s an ObjC method is shown in Listing 1. 
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= A • i?,, + 5 mod M 

irftrfp 

m ttfw rain/imi ntmihiT 
» prr%'iflus rtaufivn numh^r 
m inittai sceJ miair al n^O 
A.B^Ai “ geni'rtttftr sp^i^iri-tjnsfaniiifxrraftk-te) 


Figure 3. The Linear Congruential Generator. 

Listing 1. Euclid’s Algorithm implemented 
as an ObjC method. 

- (BOOLyiaValue:(unsigned intJargA 

relativelyFrimeTo:(unsigned lnt)argE 

< 

BOOL chk_flg; 

unsigned int lcjc_a ^ ioc_bt Ioc_r: 

// initialize the following locals 

loc_a CargA > argB) ? argA : argE; 

lQC_h “ CargA > argE) 7 argB : argA; 

// ru n Euclid's Algorithm 
while Cloc_b 1“ 0) 

I 

loc_r “ loc_a % lQC_b; 
loc_a ^ loc_b: 
loc_b = loc_r: 

I 

// check the last non-zeni remainder 
ehk_flg = (loc_a ^ 1)i 

if return the check results 
return (chk_flg): 

1 

The Lagged Fibonacci Generator 

The Lagged Fibonacci Generator (LFG) is a 
specialized version of the LCG algorithm. Tt uses the 
Fibonacci sequence of generate its pseudo- 

random sequence. Unlike other PRNG algorithms, the LFG 
algoritlim uses an initialization vector coniaining multiple 
seed values. The vector is often initialized using a 
different PRNG algoritlim. Also, the LFG algoritlim uses its 
random seciucnce to update its initialization vector, tlius 
improving the overall periodicity of the algorillun. 

Alie generating function of tlie LFG algorithm is shown 
in Figure 4. The liase mcxlulus, M, is usually assigned a value 
of 2^, where m is the integer bit size. The token o indicates 


die binary operator used by the algorithin. Tliis can lie any 
of liie following primitives: addition (4-)^ multiplication (x) 
or exclusive-OR (?). Tlic choice of operator also categorizes 
the LFG dgoritiim being used. If the algoriUim uses an 
additive or a multiplicative operaRir, it is referred to 
respectively as an Acldilk^ or Mufttpiicatim LfG, If an XOR 
operator is used, tiie algorithm is referred tt> xs a TuH>Tap 
Generalized Shift Feedback Register (GSFR). 

"Ihe choice of operator also dictates the theoretit:al 
period of the LFG algoritlim. If an adrlitive or XOR operator 
is used, die algoritlim has a theoretical period of (2^ - 1 
) *2^"^, If a multiplicative oix:rator Is used, the theoretical 
period l>ec:omes (2^ - 1) • 2^'^, which is 1/4 the period 
of the additive and XOR version. 


R„^i=Rn-p°K-<i mod M 

... ^ iijifitjtiUilirfn vn^ku’ 

/?„_ ” luitt iwti nntiiifm vatkes 

“ hititiry' n/fcntutr aniefe^ 

M » inixe rntnitthts urikiei 

pjCf ■■ - itufk es 

p> q> 0 

Figure 4. The Lagged Fibonacci Generator. 

The Blum Blum Shub Algorithm 

Tlic Bhiiii Blum Shub (BBS) algorithm was developed 
in 1986 by Lenore and Manuel Blum, together with 
Michael Shub, as a secure FRNG for cryptographic 
applications. This algorithm can also be used for 
sinurlation projects; Irowever, perfonnance issues render it 
unattractive for such applications. 

Tlie generating hinction of the BRS algoridim Ls shown 
in Figure 5, 'Ihe generau?r constant, M, is derived as a 
product of u^^o prime nutnliefs, p and q. For optimal 
[Krrfonnance, the following guidelines are proposed when 
chexAsing values for p and q: 

• Both p and q should be congruent to the modulm 3 

mod 4. In other mmis, dimding either p or q b)^ 4 
should always residi in a remainder of 3^ 

• The GGD of the expressions (p-l) and (q-l) should 

be as small as possible to guarantee a large period. 

Unlike the previous PRNGs, only the least significant bits 
of are used as the next lundom value. This ensures that 
the random scc|uence is lesbtant to linear cryptanalysis. For 
optimal security, it is proposed tliat no more di:m 
log (log (M)) bits of R^+i f^ht>tild lx- extracted and used xs 
part of the random sequence. 
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Figure 5. The Blum Blum Shub algorithm. 


The PRNG Cocoa Classes 

The Class Structure 

The IIML ciiiigram of the proposeti PRNG Cocoa class 
stniclure is sliown in Figure 6. The core class, KandBase, 
provides the code foundation that wtJl \yc u.sed by 5 other 
subclasses. Hach sulx:lass implements one of die PRNG 
algorithms covered in this article. 



Figure 6. UML diagram of the PRNG class structure. 


Figure 7 is the UML diagram of the RandBase core 
class. For pur^wses of clarity, I use tlie more familiar 
ObjC syntax (as opposed to the .standard UML 
convention) in describing the properties and methcxls 
contained l>y each class. 

Three NSString properties store information 
describing the PRNG class. These are modified using 
the setDescription : toSuring method, 'i'he 
information stored is tlien displayed using tlie 
description meihod. 

The prngSeed property stores the seed value used 
hy the PRNG algorithin. Casting it as a generic datatype, 
id, allows the flexibility to use any Cocoa object as a 
potential seed. This property is initialised t>y the core class 
using either the inirWithValue or 
initWithUnsignedlnt methods. 

'fhe prngValue property stores the current nindom 
value generated by the PRNG algorithm. It is initially set 
to the same value as prngSeed through the placeholder 
method, InltModelOnReset. ihis property is casted as 
an NSNumber so that the random value can be 


represented in any one of the following datatypes: string, 
unsigned integer, double, etc. This property is acce.ssed 
and modified respectively using the randomValue and 
setRandomValue methods. 

The placeholder method, InitModelOnReser, 
contains the initialisation code unique to the PRNG 
algorithm. Each of the RandBase sulx:lasses overload this 
methtxl to set tlieir own descTiplion strings, default seed 
values and generator consianLs. 

The pLtceholder melliod, generate, contains liie actual 
PltNG algorithm. Tills is also where tlie actual numeric value 
of the seed is determined. 'Ff-ie RandBase sulx:lasses overload 
tills method with their own implementations. In tfie core 
class, this method defaulLs to the BSD library function, 
randO, as Lite random numlxrr generator. Also, the 
generator Is initialii^ed in tlie initHodelOnReset metlicxi 
Ltsing the last random numiier generated by rand C). 

Regard I es.s of what algorithm is usc*d, tlie generate 
method saves the new random number using the 
setRandomValue method. It also returns the random 
number as an NSNumber. 



Figure 7. The RandBase core class. 


All of the RandBase sulxiasses propfxsed in this 
article will generate random sequences of 32-hit unsigned 
integers. Support for other nurnerkal datatypes (64-bit, 
signed, etc.) can l>e accomplished by simply modifying 
each subclass. 

The RandMSM Subclass 

Figure 8 .shows the UML diagram of tlie RandMSM 
sulxrlass. This sulxlass contains the NSRange property, 
Tnsm_mask, which stores the position and length of die 
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midclle-viiluc mask. The contents of itiis property are 
accessed using the setMask and maskValue merhcxls. 

Tlte overloaded mctluxl, generate, implements the 
MSM algorithm as shown in listing 2. This mcdiod first 
retrieves tltc previous random value and aiiculates its square 
product in 64-bit prec:isit)n. It tlien converts the resulling 64- 
bit value to an NSSUing, 

If a middle-value mask has Ixren dcTined, die method 
retrieves the mask and apf^lies it to the NSSrring data. 
Otlierw’ise, it uses the string length to make a lx:si-guess 
estimate of the middle value range. The extracted 
substring is then converted to a 32-bit unsigned integer 
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Figure 8* The RandMSM Subclass. 


Listing 2. The [generate] method 
(RandMSM.m). 

(NSHumber generate 
I 

NSStririg •str^V'al: 

NSRange old_nisk* new,.nisk; 

BOOL str^chk; 

unsigned ini: str_tiiLax, ul3 2_val j 

unsigned long long ui64_val; 

if initiaU^t- the following locals 
ul64_val «* 1 [super randomValue] 
uneignedLongLongValue}r 

ul64_val “ ui&4_val * ui64„val: 
str_val = [NSString strlngWithFormat. 
ui64_val]: 

old^msk = [self maskValueJ: 
str_max - tstr_\?al length] : 

if determine the default MSM mask settings 
3tr_len “ str„nsax / 2 + (str max % 2) ; 
str_pos " str^leri / 2j 

if validate the current mask settings 
If Cold_msk.location 1= old_msk.length) 

I 

if use the current mask settings 

new^mcik. location - (Qld_iiisk. location > str ^max) 
? str_pos I old_iJisk* location: 
new_mak. length = (old_msk.length > str_tnax) 

? str_len i old^msk.length: 

J 

else 


if use the detault mask settings 

uev/_msk NSMakeRange Cstripes . str_len) ; 

if extract the middle value 

etr_val "= [st r_val substringWithRange;new_msk] ; 
ui32_val =* [str^val IntValue] ; 

if save the new random number 
[super setRandoraValue:ul32. val ]\ 

if return die new nindom numl>cr 
return ([super randomValue]); 


The RandLFSR Subclass 

'Fhc UML diagram of the RandLFSR sulxrlass is shown 
in Figure 9- lliis subclass contains one private property, 
lfsr_taps [], which is an anay of 32 BOOL datatypes. 
Contents of this property are accessed using the 
setTapAt Index and isTapSet At Index methods. 

The overloaded method, generate, implemenLs die 
LFSH algtirithm CLisiing 3)- The method first retrieves die 
previous random value as well as die tap mask. It applies 
the mask to die random value thus isolating the desired 
bits, 11ie msb is then determined by computing the odd- 
parity of die lapped bits* Afterw^ards, die previous random 
value is then shifted to the left by one bit, and the msb 
applied to the shifted result* 



Figure 9, The RandLFSR Subclass. 


Listing 3 - The [generate] method 
(RandLFSR, m). 

- (KSMumber *)g£^nei:ate 
I 

unsigned int old_val. new_val, msk_val; 
unsigned int bit^poe, bit_val, bit_nisb: 

// initialize the foUowmg locals 

old_val = t[super randamValue] unsignedIntValue] ; 
rask„val " [self getXapMask ][ 

if dcierminc the masked bit values 
iiisk_val = old val & mek_val i 

if tletemiinc the bit parity lodd-parity of 11 

bit_Msb = 0x0; 
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for (bit_poa = Or blt_pos < LFSR_HAX: bit_pos++) 

I 

biT:_val = 0x1 & nisk_val: 

bit_msb = Cbit_iiiab — bit_val) 1 0x0 : 0x1; 
ro£Tk_val “ inslc_val )“> Oxl: 

} 

// update the currcni raodom value 
new_val ■ old_vai >> 0x1; 
bit_msb ^ bii:_i!isb « CLFSR_MAX * 1): 
new_val = new_val | blt_msb; 

// save the new mndotu nuinher 
[auper setRandomValuernew^val]: 

if return the new nindom number 
rerurn C {super randoinValue]) : 


The RandLCG Subclass 

Figure 10 shows the llMh diagrani of the RandLCG 
subcliiss. This subclass contains three properties (lcg_a, 
lcg_b and lcg_m) to store the genenitor-specific 
constants of the algorithm. The contents of these 
properties are modified by the 

setConstA: ConstB: ConstM method, and are 
accessed by the methods: get Const A, get ConstB and 
getConstM. 

The overloaded method, generate, implements the 
LCC algoritlim as shown in Listing 4. The method first 
retrieves the previous nmdom value as well as the 
generator-specific: cronstanis. It then calculates the LCG 
genenilor function shown in Figure 3 at 64-bii precision. 
Tlie modulus openiticm, however, Is perfonned at 32-bit 
precision, resulting into the new random value. 

Tlie checkForError Rinction checks to see if the 
sulxlass will generate a random sequence witli an optimal 
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peritxi. If so, it returns an Er r_Nonej otherwise, it returns the 
appropriate error flag. The 

isValue;divisihleByFaGtorsOf hinction returns a 
YES if die specified numters share the same prime numl^er 
factors. Finally, the isValue; relativelyPrimeTo 
hinaion (listing 1) perfonBs Euclid's Algorithm on the 
.specified numbers. It returns a YES if botli numbers are 
relath^ely prime. Botin functioas work in conjunction witli tlie 
utility hmetion, checkForError. 



Figure 10> The RandLCG Subclass. 


Listing 4. The [generate] metliod 
(RandLCGm). 

* (NSNumber *)generate 
i 

unsigned long long ul64_val, ul64_e, ul64_b; 
unsigned int ui32_vel, mod^val; 

// initialize the following locals 
ui64_val = f[super randomVaiue] 
utisignedLoTiRVaiue] ; 

uie4_3 [self getCemstA] : 
ui64_b ^ [self getConstBl ; 
inod_val = [self getConstMl ; 

//calculate the next ram loin value 
ui64_val = ui64_val ^ ui64„val; 

ui64_val = ui54_val + ui64_b; 

ul32_v3l = ui64_val % mcjd_val; 

// save the new randt>ni number 

[super setRandomValue:ui32_val]; 

// rciiim ihc nerw random number 
return ([super randoroValue]): 

1 

The RandLFG Subclass 

The UML diagram of the RandLFG .sulxrkss is shown in 
Figure 11, This .subclass contains two propeities (lf g_p and 
If g_q) to store die generators-specific constants to lie used 
by the algorithm. It also a)ntains die private property, 
If g_ops, w’^hich determines the binary operator to be used. 
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Tile a>nienLs of tJiese pioperties are modiflcxl by the 
set Cons tP: const Q: opCode and are acxx^ssecl by the 
methods: getConstP, get Cons t:Q and get OpCode, 

Tfic RandLFG subclass also maintains the 
initialization vector in the form of the NSMiUal>lcArray 
property* lfg_vec. AnolhcT property* lfg_liiii* 
contains die maximum size diat the vector is allowed to 
grow. Lastly* the Ifg^cnt property, keeps rrac?k of the 
number of r:mdom values generated by the subclass. It 
is used to determine which entry in the initialization 
vector will be updated. 

llie overloaded method, generate, implements the 
LFG algoriilim (Listing 5). The method first retrieves the 
previous random value as well as the generarors-spec'ifie 
constants. It then determines which seed value to retrieve 
from the iniiializatit)n vecion Tlie methcjd calculates the 
next random value at 64-bit precision* using the selected 
binary operator it then updates the iniLialiZittion vector 
with the 32-bit result. This is the only sulxlass that does 
not save the new random value using the 
setRandomValue methcxl 



Figure 11. The RandLFG Subclass. 


Listing 5- The [generatel method 
(RandLFG.m), 

- (NSNumber *)generate 
I 

unsigned int idx._p* idx_q, vec^lim* ul12_val; 
unsigned long longui64_p, ui64_q; 
unsigned long long ui64_val, ul64_and, ui64„or; 
LFGjOPCODE arg_op£5; 

// validate the inilialiyiation vector 
if ([super iaSeeded]) 

I 

// initialize the following locals 
idx_p “ [seif getConstP] ; 
idx_q [self getConstQ] : 


vec_lltii “ [self gerVec tor Size] ■ 
arg_ops = [aelf getOpCode] j 

// calculate the vector lEtdiccs 
idx_p = lfg_cnt ldx_p: 
idx_p " idx_p % vec_lim; 

±dx_q “ lfg_ciit - idx_q; 
idx_q = idx_q % vec_li[nr 

// retrieve the values at the specified indices 
ut64_p ™ [self gerValtieAxlndex: idx p1 ; 
ul64_q = [self getValueAtIndex;idx_q] : 

// calculate the next state value 

switch targ^ops) 
f 

case IfgAdd: 

// — pmg:lTG:additive 
ui64„vai = iii64_p + tjl64_q: 
break; 

case IfgMul: 

// — pmg:LFG:mullipljcaiivc 
ui64_vai = ul64_p * ttl64_q; 
break: 

case IfgXOR: 

// — prngiLFGrXOR 
ul64_and = ul64_p & ui64_q: 
ul64_or = ui64_p | Ui64_q; 
ul64_val = ui64_or 4 '“Cui64_and) j 
break: 

J 

// incliRle the mtHlulus base 

ui32_val = (unsigned int)(ul64_val % 

DFLT BASE): 

// update the Initialijcation vector 
Ifg_cnt++; 

ldx_p = lfg_cnt % vec_iim; 

[ijelf setVaiue ;ui32_val at Index: Ifg^cntJ ; 

// save ilie new random nunilxrr 
[super setRandomValue:ui32_val]: 

// return the new random numl^er 
return ( [super randoTnValue] J : 
l 

else 

// return the current seed value 
return (Isuper aeedValue]): 

1 

The RandEBS Subclass 

Figure 12 show.s the IJML diagram of the RanclBBS 
subclass. This subclass ctjntains two properties {bbs_p 
and bbs_q) to store the prime con.slanls* p and q. ft 
uses the property, bbs_m* to store the generator 
consiant M. The subclass also has the property, 
bbs_niask, w^iich is the user-denned bit mask used to 
extract the new random value. Finally, it has the BOOL 
properly, bbs_opt, dictating whether to u.se the user- 
defined l>it-inask or the optimal one dbeussed earlier in 
this article. All of these propenies are accessed by their 
respective metfiocls, 

Tlie overloaded method, generate* LmplemenLs the 
DBS algorithm as showm in Listing 7. The metliod first 
retrieves the previous random value and the base 
mcxlulus, M. It calculates the square of the random value 
at 64-bit precision, and then determines the modulus 
result at 32-bii precision. Afierwards, ihe method applies 
the appropriate l>iL mask to the modulus result. It then 
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repeals all of ihe aforementioneci steps until a fvjll 52“l>it 
random value is Ibrmed. 

By default, the suWass uses the optima! I>il mask to 
extract the bits that will comprise the new random value. 
The methods, optimalMaskLength and 
optimalMaskValue (Listing 6), arc used Lo deierinine 
the optimal bit mask. ! lowever, tlie subclass can also use 
a aser-defmed hit tnask. 'Iliis is done by setting the bit 
mask using the setMask methcKl and passing a NO to the 
useOptimalMask method. 





Figure 12. UML Diagram of the RandBBS Subclass. 

listing 6. Calculating tlie optimal bit mask 
(RandBBS.m). 

// — Calculate the number of bits in the optimal mask 
- (unsigned Int )optinialHaskLength 
\ 

unsigned int ui32 len; 
double dbl val; 

// calculate the optimal mask length 

dbl val * (double) [self getBaseModulus] ; 

dbl_val ” loft(dbl_val): 

dbl_val - log(dbl_^val) j 

ui32_len ^ c«il(dbi^val); 

if return the calculation results 
return(ui32_l©n); 


// — C:alcuiate the optimal BBS mask value 
- (unsigned lnt)optiiiialHJiskValue 
I 

unsigned int ul 32 ^Ien* ui 32 _rask* ui 32 _,blt; 

// calculate the opimial mask value 
ui 32 _len = [self optimalHaskLengthJ; 
ui32_(osk - OaO: 

for (ui32_blt = 0i ui32_bit < ui32_leni 
ul32_bit-H-) 
f 

ui 32 _mBk ^ ai 32 .insk | 0 x 1 j 
ui 32 mak = ui 32 _mnk c< 0 x 1 : 


ul32„msk ^ ui32_msk >> 0x1; 

// return the caicukitiun results 
return (ui32_insk): 

I 

Listing 7. Tlic [generate] method 
(RandBBS.m). 

{NSNuraber *)genera i e 

[ 

unaigned long long iii64_val: 
unsigned int ui32_val* ui32 mod; 

unsigned int ui32_msk» msk len, mak_cnt, nink_inax; 

// initialize the following locals 
ui64 val = [[super randonVslue] 

UnslgnedLongValue]; 

Lii12_mnd = [self gettiaseHodulusJ ; 

// is all opiimal mask reC]ucsietl? 

If ([self IsMaskOptinial J) 

i 

msk_ien = [self optimaiMaskLengthl: 
ui32_msk = [self optlroalWjinkValue] : 

I 

else 

I 

msk_len * [self getHasktength): 
til32_muk = [self getMaskValueJ : 

1 

// calculate the new random value 
msk^max =32 / mek_len: 
ui32_val =0x00; 

for (msk ont = 1| Tnsk_nnt msk_max; tiisk_cnt++) 

I 

// calculate the next raudoni value 
Ui64_val = uj64_val * ui64_valT 
uib4_val = ui64_val % ui32_iiiQd: 

ui32_val = Ui32_vai | tui64_val & ui32_msk); 
if (msk_cnt < iisk_max) 

ui32_val = ui32_val <C msk len: 

I 

// save the new random number 
[super setRandoinVal ueiul 12_val ] : 

// return the new random iiuml)er 
return C [super randoinVulue] ) ; 


Testing the PRNG Subclasses 


A variety of algorithms arc available for tesiing the 
cfficat'y of PRNG implementations. These algorithms 
examine tlie geiicrated random ^se([Uence to determine 
whether a PRNG is properly configured, Hicy also 
determine wliether or not the generated sequence is 
staustically .sulLahle for the task al hand. 

PRNG test algorithms ningc from the elegantly simple 
Ijemprd-Ziv to the mathematiailly oriented maxiiiium-of-t 
test Tliey ail require a large numlxfr of random values in 
order to lie effective. A large sample size helps reveal 
indications of poor randomness such as skewing ness. In 
fact, it is tjuiie common to have a PRNG generate at least 
1(X)0 random values for testing pun^oses. 

This article introduces three simple and effective 
test algorithms: LempebZiv, Run Mel hod, and Spectral 
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Method. The demo applicalicm, DiccC, uses the Spectral 
Method as its test algoritliin. 

The I^mpel-Ziv Method 

The lempeUZiv metlicxl Ls one of the simplest test 
algorillims for a PRNG. In its most basic form, the PRNG in 
question first outputs its random secjuence into a lanary file. 
Tills file is then c:ompressed using the LE algoritliin or any of 
its variants. Some implementations do away with file T/O by 
compressing the random setjuence directly in ilie memory. 

Since the LZ algoridim works by identifying and 
const>iidaling byte patterns, a pure random sequence 
should have a near-^^ero compression ratio. The 
compression ratio of PRNG random sequence^ however, 
should Ixr very low if it has a near optimal period. Higher 
compression ratios are often gtK>d indicaLions of non- 
random patterns present in the sequence* 

The Ixanpel-Ziv method is an effective liaseline test 
when comparing various PRNG algorithms* It is also 
useful for fine-tuning algorithms such as LCG or LFG, 
whose overall performance is strongly depended on its 
generator constants or seed values. 

The Run Method 

Tlie Run method converts a random ,seciuence into a 
series of states. An ascending stale is where each 
subsequent random value increases witJi resjiect to time, 
ft is reprcscnied l)y a (+) sign. The opfmsite would be a 


descending state, which is represented by a (-) sign. If 
the values remain unchanged, the state is considered to 
lie neutral and is represented by a (0) * 

To illustrate, the random set|Lience 

255 75S 02EJ 974 984 320 581 765 

lias the following random values exhibit an ascending state: 

255 -> 75B 029 -> 974 974 984 

320 -> 583 583 765 

whereas the following exliiliit a descending state, 

758 -> 029 984 > 320 

'Ihis reduces the random sequence to die following state 
see|Uenee 

Once die state sequence? is determined, it becomes a 
simple matter of examining the sequence for any patterns. 
Long successions of one or more states are undesirable as 
they indicate a numerical bias in die PRNG random sequence. 

The Spectral Method 

The Spectral MeLhtjd divides a random sequence into 
specific intervals (sometimes known as a sj^ectral period) 
and then plots the number value,s within each interval as 
a scatter graph. The result is a spectrum of data points that 
can then be examined for patterns. 
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Figure 13 shows a typical spectnjm gn^ph for the BSD 
rand 0 function. 71ie random set[Lience consisUs of 1000 
32”hil unsigned integers. Tl is generated using a seed value 
of Oxlebbccf. Tiw scatter graph is then drawn using a 
sixfctral period of 200 values. 

spectrum Graph 



Figure 13. Spectral graph of the BSD randQ function. 

Notice that the daui j:K)inis are well distributed acttxSsS tlie 
resulting graf^li. Tliere are no aieiis where the data ptiinis 


vvt>uld cluster togetlier foniiiiig a pattern. Now, cx>mf:iare this 
witli tlie spectrum graph for the RandMSM sul xIassCFigure 
14). Itie random .se<|uence of HXX) integers used in this 
graph is generated watli a seed value of 0x457, Notice the 6 
dashed lines located at the Ixmom of the graph. TMs 
indic’ates that the set|uenc:e converged u> 6 distinct values 
after 11 itcratioas. Tills is an undesirable trait, especially 
ccjnsidering tliat the implemented MSM algoritlim is 
expected to have a peritKi of 9999 values. 

O O spectrum Graph 



Figure 14. Spectral graph of the MSM generator. 
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The spectRiin graph for tlie other tlirec siilxrlasscs fared 
much l^^tter by conipaiison. Shown in Figure 15 is tlie 
spectRim grapii for the KantiLh’SR sulx'lass. Its mncioni 
sequence is generalcd using a seed value of Oxbeef. IJke tliai 
of the liSD rand () funclicjn, die grapJi siiows weli- 
clistril:>utecl data points widi no noticeable patterns, 

O O Spectrum Cr»ph 



Figure 15. Spectral graph of the LFSR generator. 

Summary 

The ability to generate random setjuenees is an 
essential component of any software tx^de libraiy. Since 
digital computers are deterministic machines, the only 
feasible way of generating random sequences is thrcnigh 
the use of a pseudo-random numlXT generators or 
PRNGs. Five different PRNG algorithms are then 
introduced and discussed, 

liitei; die class, RandCxire, Is proixised to serve as die 
basis for developing a i-^RNG C 0 C 02 object, i'ive different 
subclasses are dien 1 rased off tfie RandCore c:iass, with each 
siilxlass implementing one of Uie five PRNG algorithuis, Boiii 
ii^mdQire and its five sulxlasses are implemented in tlie 
demt) application, Dic:eC. Also, intrcxluced are three test 
algoritiiins for testing tlie PRNG sulxdasscs. One of tliese 
algoridims, the Spectral Methcxl, Ls implemented in DiceC to 
evaluate the performance of RandCore and its five subtilcisses. 
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AppleScript s variable 
w down your scripts!) 


By Ryan Wilcox 


Introduction 

Those who know AppleScript well are very familiar 
with obscure AppleScript tricks, magical incantaiions to 
make their script run faster These incantations are 
usually due to an understanding of AppleScript's data 
sharing mechanisms, which are thoroughly explained in 
this article. 

Learning liow different types of variables work is 
an important step for any AppleScripter, Sometimes 
AppleScript behaves in ways that are unintuitive and 
often frustrating to those wfio don't understand what’s 
going on. To those that don’t imderstand These 
different types, some of AppleScript's behavior, looks 
like bugs in the language, but this is rarely the case. 

This article discusses three classifications of 
AppleScript’s variable types, examines methods of 
appending an item to a list, and then examines the 
different kinds of copy operations available to a scripten 
This anicle is not meant to be an introduction to the 
language, but rather read by someone who has a working 
knowledge of AppleScript. 

Variable Types 

Pure, or “Vanilla*' AppleScript (AppleScript that 
does not depend on any third party extensions aka: 
OSAXen, nor applications) has three different 
classifications of variable types: scalar types, container 
types, and other types. The first classification, scalars, 
is a type that can only hold one item. An example 
being a variable that contains the number 27. 
Numbers, reals, as well as dates, strings, and texts are 
also scalars. 


The second classification is container types. A 
conlainer type is a type that can hold multiple values. For 
example, a scalar could contain the number 2 7, while a 
list could contain ( 27 . 3 , 5 . 6 ), and a record could 

contain [iteml : 27 , ltGm2 : 3 , itemS : 5 , 

item4: 6). Lists, records and script objects are 

container types. 

The last c:lassificaLi()n is r)Lher types. Other types 
include references, as w^ell as constants and unit types. 

The information presented in this article (and this 
.section in parltcular) is all hacked up by 
experimentation, most of which was condensed into a 
test script. This script contains nearly four-dQ?.en 
handlers that lest the assertions made in this article. 
Most of the snippets of code you'll find are from the 
test script as well. The full script is found on the Web 
at: htTD://www.wilcoxd.cQm/ artides/asreferences/ Each 
snippet of code in this article is backed by a handler 
in the testing framework, which wdll return true if the 
conditions have been met, or false if the test lias 
failed. Handlers can easily be located by using the 
Table Of Contents at the top of the test script. Doing 
the timed tests included in the test script requires the 
Jon's Commands OS AX, found at 

http://www.seanet.com/-jonpuQh/ The script can be run 
without the timed tests by setting the doTimings 
property to false. 

Scalar and Container Types Compared 

There is a difference in how AppleScript deals 
with scalars and how it handles container types. 
Container types, internally, use something the 
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AppleScript Language Guide calls “Data Sliaring'" (page 
206). The understanding of this “data sharing” concept 
first requires an understanding of how variables work 
in AppleScript. 

An AppleScript record, deconstnicted, might l>c ihc 
easiest way to see the beliavior of AppleScript's variable 
types, especially when accompanied by some illustrations. 

set ttiyRec to IvarOne; 1, varTwo: 2. varThree: 

Figure 1 represents what myRec l<K>ks like: 


VarOne 

VarTwo 

VarThree 

1 


2 


3 


Figure I: tnyRec with three scalar items inside it 

Now we create a new item in rayRec * 
illustrated in Figure 2; 

set tiiyRec to myRec & (varFour: 

and represent it by Figure 2: 


VarOne VarTwo VarThree VarFour 


1 


2 


3 


4 


Figure 2; myRec with four scalar items inside it 


Simple enough. Figure 3 shows, the situation changes 
when we set varOne, varTwo, and varThree to be 
container types instead: 

ser myRec to ( varOne: (IK varTwo: {2[* varThree: 
13} I 

myRec represented graphicaliy looks like Figure 3: 


VarOne VarTwo VarThree 



Figure 3: Diagram of our variables as container types 

As seen in the diagram, container types refer to 
their contents by pointing to where the data is “over 
there”. In essence, container types in AppleScript work 
a lot like aliases in the Finder. An alias points to 
another file c^r folder, allowing you to access that item 


from a different logical location in ytmr file structure. 
Likewise, container types let you refer to the same 
value “from" multiple variables. Aliases also take up 
less hard disk space than making a duplicate of the 
item itself, an advantage shared by AppieScript*s 
container types: the same values only exist in one 
place in memory, instead of having multiple copies of 
the same data. 

This means we can change two things witli list 
items, just as we can with aliases. We can change the 
concents of the variable (the data dial is .shared), or we 
can change the variable itself (where it “points" to). 
First, Figure 4 shows myRec when we add another 
element to it: 

set myRec to myRec & tvarFour: varThree of myRec) 


VarOne VarTwo VarThree 


item 1 

item 1 

item 1 

VarFour 





1 

2 

S'* 



Figure 4: varFour shares the contents of varihree 


Notice how varFour shares varThree's data. As you 
might expect, any change to 131 will be mirrored in botli 
var Three and varFour, as the data is shared between 
these two variables, as seen in die following line of 
Aj>pleS<Tipt (also shown in Figure 5). 

set Item 1 of varThree of myRec to 4 


VarOne VarTwo VarThree 



Figure 5: Changing the contents of varThree 


Changing where a variable points is also possible, 
shown in Figure 6: 

set varThrf*f» of myRer to 12,5) 
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VarOne 


VorTwo 


VarThree 


item 1 

Item 1 

item 1 

VprFoyr 





. 1 

1 

2 

2,5 4 



Figure 6: Changing varThree 


The above line changes only where varThree 
points to, as opposed to the contents (aka: the shared 
value) of what it was sharing with varFour. It would l>e 
as tf you created two aliases in the Finder (alias A anti 
alias B), lx)th of them pointing to the same document, and 
then you selected a new original for alias B. Alias A 
continues to point u> die original item; only alias B points 
somewhere else. 

AppleScript shares the contents <if ct)niainer items, 
instead of sharing the item itself. This am lie proven 
with a liandler from the test script, 
testiContainer ItemsSha reSca la r s (). 

to testContainerlternsShareScalars () 

(let myltcm to ill 

set myList to myItem 

set layList to myLisl h tnyltera 

set item 1 of inyitem to 45 

return (myList ±s equal to 11»1 I and myltem Is 
^qual to 1451) 

end testContalnerltemsShareScalars 

rf item I and item 2 of myList .sliared item 1 of 
my Item itself, they would reflect the change in line 3. 
Instead, item 1 and item 2 share llie amfents of item 1 of 
inyltem, just like our example in Figure 6. Items in 
myList remain unchanged: they still share the .same 
value, even if' my Item dws not anymore. The test script 
has two tesLs that further explore this hinaicynaliiyr 
testContainerItemChangeReflectedInShared() 

, and 

testrContalnerltemChangeReflectedlnShared (). 
testContainerltemChangeReflactedInShared() 
proves that even if item 1 of my Item is a container, instead 
of a scalar, the behavior is the same as 
testContainerltemsShareScalars(). 
testContainerItemChangeReflectedInShared{) 
proves that if item 1 of my I tern is a container, that 
t'fianging the contents of my Item is reflected in rayLiat. 

C/C++ or Java programmers might recognize that 
container item.s act a lot like pointers or references in 
their languages. They would be correct, to a point. 
This article pointedly avoids the term '‘reference” to 
refer to container types, to make it more accessible to 


scripters not familiar with those languages, and to 
avoid confusion with AppleScript's actual reference 
type, discussed in the next section. Care should be 
taken, especially when reading AppleScript mailing 
listsj as container items are often called "references”, 
despite not l>eing associated with AppleScript's actual 
reference type. AppleScripFs container types are 
different from the reference type because they are 
automatic, and don't have any of the restrictions of 
actual references. I'he test script tries to avoid using 
the term "reference” as a substitute for “container 
types”, but sometimes uses it for brevity. 

The Reference lype 

In vanilla AppleScript, the reference type exists to 
allow^ the scripter to point to satlar daia. Try running the 
following handler: 

on run 

set X ta tru^ 
s€5t y to a reference to x 
set contents of y to false 
log "x X ae string 

log "y ^ S y as string 
end run 

t*Eveti! Log Output: 

X = false 
y = false 

•) 

Here y is a reference ihai shares data with x. 
Rememlier that the difference Ixiween scalar types and 
container types is ilial container types |X)ini to data “over 
there”. The reference type ixiints to data “over there” as 
well, and reflects changes to the sluired data [ust like 
container items do. 

Below is a snippet of code, based on the 
changeAReferenceTypeO handler from the tesl script: 

set refProp to "world** 

set y to a reference to refProp 

set K to a reference to refFrop 

set y to *‘hello“ 

set contents of Z to **foo*' 

—t^fPrup is ec[ual m “ftHi'' 

—anti <y is to “hello” 

—anil (contents of z is equal to ^foo")) 

First it's important to note that refProp is actually a 
property. Well gel into why later in this section, but for 
now just remember that fact if you're I tying to reproduce 
this test at home. 

Lines 1-3 of the liandler create our three variables, 
piciured in Figure 7: 
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refProp 


y 2 



Figure 7: Initial state of refProp, y and z 


Line 4 changes the value of y to "hello". Kemember 
that container types have two different types of values: 
what they point to, and tlie contents of the variable. In 
Figure 7, y points to ref Prop, and points at the value 
“world". Reference types work the exact same way. 
Figure 8 shows the stale of y after line 4* 



Figure 8: set y to "hello" 


Here we have only changed what y points to, so z 
has the same value as it had l)efore. 

Now, in line 5, we change tlie value z points to, using 
AppleScript's contents of syntax. Contents of 
allows us to change the value being pointed to by the 
reference type. 



Reference types seem like they would l>e useful, but 
they have some pretty limiting drawlxicks, according to 
AppleScript: The Definitive Guide (Section 1L5), and our 
tests here. Try mnning the following script: 

to main() 

set X to true 

set y to a reference to x 
set the contents of y to false 
—AS runtime error: “can’t make ’x' into type reference 
end nain 

main C) 


Wilile y points to x, we get an euor when wc try to get 
the contents of the reference. AppleScript: DefinititJe 

Guide has a work-around: make x a pniperty, lliis is what 
changeAReferenceType 0 does with ref Prop. 

property x : true 
on mainO 

set y to a reference to x 
set the contents of y to false 
lo^ "x “ fit X 

log **y = “ y 
end main 

mainO 

CEvent Log Output: 

X = false 
y == ialsc 

*) 


Further experimentation leads to an interesting fact: 
you cun create a useful reference type using a 
reference to if and only if you are in Uie (implicit or 
explicit) run handler, as the following script proves. 

on run 

set X to true 
set y to a reference to x 
set contents of y to false 
log *'x = " £f X as string 
log ‘‘y - & y as string 

end run 

C*Eveni Uy^ Output: 

X = false 
y = false 


For those of you noi aware, when running a script 
AppleScript first U)tjks for a handler explicitly named 
run 0 to execute, and if it d(X!sn’t find it, then executes 
any commands not in a handler, assuming that (the 
implicit run handler). 

Referencing a list in the run handler: 

on run () 

set X to [true, " foo"l 
set y to (a reference to x) 
set contents of y to [false* bar"} 
log '■k=** Sixas string 
log “y = ** St y as string 
end run 


Here we are changing the value z points to, the 
value of ref Prop* 


(•Event Log Output: 
X = false bar 
y = false bar 

•) 
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The referenre lypc seems like a useful way to save 
memory (and lime) when you want one variable to mirror 
a scalar variable’s value. In reality, thanks uj ilie 
restrictions of the reference type, it is probably l^etter and 
easier to use a container type instead. 

Beyond our explorations of die reference ty|K% die 
different mechanisms of copying can confuse scripters 
and could lead to slower than expected performance in 
scripts. The next section of diis anicle covers this 
important topic* 

Conclusions on Variable Types 

Knowing the difference lietween sailar and ctintainer 
types is an impoitani step in understanding AppleScript *s 
behavior in certain circumstances (like using the set 
command). AppleScriprs reference type, while not as 
useful or powerful as other types, is important to know 
alxiut anti may prove useful in your script writing* 

The next section shows several test handlers that 
further illustmte the difference lietween scalar and 
container types. Now, test your knowledge by trying to 
guess die output of the event log of the folU>wing 
liandlers, based on die information in die previous 
section. 

Test Your Knowledge! 

This scclion is comprised of 5 functions from tliis 
article’s test script. See if y<JLi can guess what the output 
of the event log will lie in each case. 

Tlie Test 

on xAnYScaiarsC) 
set X to true 
set y to X 
set y to false 
lo& “X - “ & X 
log **y “ " & y 
end xAnYSealoro 

on xAndYListO 
set X to ftruej 
set y to X 

set Item 1 of y to false 
log "x = " & X as string 
"y = " & y as string 
end xAndYLlst 

on xAndyListCopyf) 
set X to true 
copy X to y 
set y to false 
log *x " " & X as string 

log “y “ ** & y as string 

end xAndYListCopy 

on copyWithLists0 
net X to (truel 
copy X to y 

set Iteo i of y to false 
log "K = " & X as string 

log "y “ " & y as string 

end copyW±thT*ists 


The Answers 

xAnYScalarsO Event Log 
(*Event Ijog Output: 

X = true 
y = false 

-) 

xAnYUstO Event 1/ig 
(*Event Log Output: 

X = false 
y ^ false 

•) 

xAudYListCopyO Event l-og 
(*Event Log Output: 

X = true 
y = fidse 

*) 

copyWithLisisO Event Log 
(*Eveni log Output: 

X = true 
y = lalsc 

*> 

The Answers, Explained 

’ITiese tcjils show the basics of !iow AppleScript's 
variables react ditferenlly to different situations. First, in 
xAnYScalars (), wc have a test tliai sels two scTilars. Itie 
line set y to x copies the value from x and puts it into 
y. Sinttf y is a copy, we change its ct>nients and not liave it 
rellected in x. 

xAndYLlstO is cliffereni in that it deals with 
container types. Using set wiili a ctaitatner type only 
ptjinis to the original data. Thus, in xAndYListO, y 
shares x's data, claiming it as its own, and changing the 
value of any element inside of y w-ill he reflected in x. 

You might expect the same results from 
xAndYListCopy C) as those from xAndYListO, No, 
for this fund ion uses the copy keywx>rd, w^hich results 
in a duplication of all the data, down to every last 
scalar value, from x into y. This duplication (alst^ 
called **deep copy'’) means that there are two different 
copies of (true), and changing one copy does not affect 
the other. This wt>Ljld be like duplicating a file in the 
lunder, and making a motlifiealion to one, copies 
ct)nients, one file contains the new data, while the 
t)ther file remains Lite same as ii w-as before. Copy 
operations are covered later in this article. 

The next section will take the knowletlge of scalars 
and container types, and apply it to the simple operation 
of adding an item to the end of a list. 

Appending To A List 
Under the Microscope 

Apjwnding an item U) a iLst happens a fair deal in 
AppleScript,s, and can be a source of .slowness if not done 
correctly. In the following .sections we’ll investigate 


48 March • 2006 


WWW.MACIECH.COM 





several dilTereni ways tn append an item to a list, 
discussing both sjx'cd and differences in the operations 
pcrtbrmecL Space considerations prevent dcuiiied analysis 
Willi all permutatioas, hut we'll cover the more interesting 
ones in this article. Other append consrmets can l>e found 
in the test script. 

By downloading the test script you can see- the 
timings of the tests yourself, on your machine, and alsti 
further examine the handlers this author used to gather 
the data presented in this series of articles 

The benchmark machine for these tests was a 
(admittedly ancient) 4()0Mhz PowerhtM)k G4 running OS 
X 10,4,3 with 768 MB ItAM. Timings are given in ticks, 
which is 1/60^^^ of a .second. 


copy myList & mylistltem to mylist 

copy my Li St & royListItem to myList copies 
both myList and myListItem - changes made to either 
variable don’t get reflected in ilie new list. 
twiddleCopyListItemList () shows us tiyiiig to 
change the contents of iletn 1 of myList, which is a 
duplicate of (instead of sharing data witli) my Item. 

to twlddleCopyListltemlistO 
set a to 1 

set myLisx to IfaK Ul* la]* ta], (all 
copy myList to deepCopy 
set shallowCopy to Items of myLisx 
set item 1 of item 4 of deepCopy to 42 — not 
reflected 

set item 1 of item 5 of myLi^t to 23 - ref tec Led 
returTi (myLlst is equal to HI), ill. Ml* (ll. 
123]1) and (deepCopy is equal to Mil* 111. lit. 
1421. fill) and (ahallowCopy ir* equal to ((It. jl), 
UK tlK 123)1) 
end t w i d d 1 eC o p y Li a t T t cm 1. i s t 

This function will lx revisited later in the article, but 
note how the change to item 4 of deepCopy does not 
change Lite value of shallowCopy or my List, We used 
copy to construct deep Copy, making a duplicate of the 
data. Also notice how changing value 3 of myList is 
reflected by shallowCopy, 

Now, the Liming of this construction: 
timeCopyListAndListToList C) took a minimum of 
0 licks, max of 5, and averaged 1.11 ticks on the 
[benchmark machine. 


set mylist to mylist & myListItem 

The next way to append an item to a list b to use sot 
myList to myList There are things to lie aware 
of while appending container items to a container. The 
first is that, appending two lists together in this method 
will result in a ‘‘flat" list. Take the following handler, from 
die lest script: 

to setListToListAndComaitiGrLia-tltGniAppeTid () 
set a to (1. 3] 

set h to 12\ 

set b to a & b 

return b is equal to IK 3> 21 
end setLlstToListAndContainerListltemAppend 


b grew to accommodate all of a, creating a new^ 
item for every item of a, b is now 3 items long 
(count of a f count of b = 3.) 

One must be careful w4ien iniltally creating myList, 
to avc5id inadvertently changing values you didn't expect, 
as shown in the following handler 

to testEmptyLlstfiChangesConiientis 0 
fler GmptyList to I) 
set myItem to 111 
set myLlst to eaiptyList my I tern 

set Item 1 of myList to 123 
set myLlst to myLlst & myItem 

return (myItern Is equal to [1231 and myLlst Is 
equal to 1123, 123]) 

end testEmp tyListsChange sCont ent a 

One might have expected myList to be [ 1 * 123 J, 
instead of 1123, 123}. On line 3 of this handler, myLlst 
behaves as if we had used the “set myList to 
my I tern'' syntax, where myLlst simply rellects ray I tern, 
instead of having item 1 of rayList .share ray I Lem, Figure 
10 show\s this distinction. 

nrayiist 
item 1 


vs 

myItem 
Item 1 

9 


Behoviop Seen Behavior Expected 

Figure TO: Seen vs expected behavior in 
testEmptyUstsChangesConteiitsO 

t i meSetl.lstToListAndList (), in the test 
script, gave us a min value of 0 ticks, a max of 2, and 
an average of .8 ticks. This is very close to the timing 
ftset myList to myLlst & myListItem, timed 
with timeSetListToListAndScalar 0 (found in 
the test script). 

set end of myList to mylistltem 

AppleScript’s syntax has many nice features to 
W'Ork on lists, first of, end of. rest of, and 
some item of, to name a few, testFirst 
OfReassignRef Item C) in the te,sting script shows, 
for example, that first of will replace the first item 
of the list (in.stead of creating a new first item, .such 
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I hill ihe previous first item is now the second item, and 
so on) 

The end of syntax aj)pends an item onto a list. For 
an example, examine the handler we use to lime this 
construct: 

to tf^^itSimpleEndOfWorks 0 
set & to (2J 
s^t b to 111 
set end of b to a 
return b is equal to It. t2M 
end testSimpleEndOfWorks 

Notice tliat item 2 of b is (2), and not simply 2, as in 
a set myList to myList £f anotherLlst 
c(^n.stnjeiit)n, it is nestled, instead of Hat. 

A word to the wise with this construction: do not append 
a variable to itself using this leclmique. At Ix^st it will result in 
a stack twerflow when you go to display it, at worse it could 
cause an infinite kx}p. Even if the list is sharing another 
variable and you tiy adding tliat variable onto the list 
s imp leAddSelfToEndOf Self Err 0 of the test script 
shows trying to append an item onto itself, and the handler 
addSelfToEndLogOverflowErrC) shows the more 
exotic case. 

Another difference with the end of syntax vs. the 
set... to... syntax is that changes are shared. I'Ue 
handlers setSndOf SharedData () and 

addToOneNorShared () in the test script prove tliis, hut 
they can be distilled with two simple examples: 

set a to (11 
set b to a 
set b to a (k ^5 

® { 1 } 

to 

set s to ill 

set b to a 

set end of b to 45 

m {1, 45} 

On line 3 the first txinstruct, it Ls like b is created aU 
over again, which would explain the dlscnepjtnty in .speed 
IxHwecn tliis and set end of. It also explains why, in tlie 
scTOnd snippet, a contains (1, 45) %vhile in die first example, 
a reiwins (If In other words: llie seexmd example acts on b 
itself, and since b shares data witli a, logging a ai the end of 
die second scTipt will show* it idendcal to b, Ixxtiuse b is just 
a leflec'don of a. 

Being able U> refer to the end of the llsl has some Liming 
advantages. Tlie Ix^nchmark machine ux)k a minimum of 0 
ticks to complete timeSetEndOfListToLlsL (), 1 tick 
max, and an average of .09 ticks. Compart? this to set 
myList to myList & my List Item, and you’ll see it 
was almost 10 times Faster! 

Conclusions on Appending To Lists 

By far the fastest method of appending an item to a 
list is to use the set end of... to construction. The 


timeSetEnd OfListlOOItemsListO and 

timeSetEndOf List 100 I terns Sea la r() handlers, 
presented in the test script, append 100 lists and scalars 
with 100 items, respectively, to a list, constructing a 1000 
item li.sL On the benchmark machine, these tests were 
identical (min of 0, max of 1, average of 0.13). The test 
script shows timed examples of copy myList & 
myltem to myList constructing this kind of 
list, one constructing the 100 item li.sl using the set 
end of«. syntax, and one using copy myList & 
myltem to„. (t imeCopyScala rAndLlstToList 
lOOItemsO and timeCopyList AndListToList 
lOOItems () respectively). These two functions take an 
average of 2.5 licks per run on the l:»enchmark machine, 
proving dial careful use of AppleScript can speed up your 
scripts, even with something as simple as appending 
items to lists. 

The next section discusses the different methods to 
copy variables in AppleScript. Along with appending 
to a list, copying variables draws on much of our 
previous knowledge about AppleScript’s variable 
types. 

The Right Copy For The Right 
Situation 

AppleScript has two different types of copy: a 
shallow copy and a deep copy. Early in this article, wc 
mentioned AppleScripfs copy txHi.struclion. A deep 
copy, which t.s triggered in AppleScript using the copy 
keyword, will fierform a deep copy: duplicating ad of 
I he data in a variable, even if you liave scalars nested 
inside of lists inside of records inside another list. A 
deep copy of sucli an object would be very expensive 
becau.se of all the data involved, AppleScript would 
duplicate each and every item in this complex 
structure. 

An alternaiive would be a shadow copy. Like a 
deep copy, a shallow copy duplicates all of the items 
in a list. Unlike a deep copy, any container items in tlie 
original list will create a new item in tfie destination. 
This item wall share the same data as the original item. 
Our scalar deeply nested inside a list would be very 
fa.si with a shadow copy, because AppleScript would 
share the original data and put tfiat in our new list. To 
expand on our earlier example of aliases, shadow 
copying a list simply creates another alias “pointing to” 
the .same file a.s the first. 

Let's examine these two kinds of copy individually: 

Shallow Copy 

A slxidlow copy c'reates items tliat sliare datit with tlieir 
respective items in tlie tiriginal list. This means that wlicn ytju 
shallow cx^py, data is not duplicatexi, !>ut the items t>f tlie new j 
list share their ciata with the items of ilie tjriginal list. 
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when yt)u create a shallow copy, iieiiis added 
or removed From either list are not reflected in the 
other list, but changing llie ctmlents of an item w^tll 
he reflected. 

You can shallow copy a list in AppleScript by 
using the items of syntax. 

set shallowCopy to items of rayList 

It is iiiiporlant to reiterate here: the items of 
shallowCopy point to the data shared by myList 
direc:tly, they are not depending on myList For 
anything beyond the initial setup. We can change an item 
on myList to fXJtrU sojuewhere else, yet shallowCopy 
remains the same. 

to ehallDwCopyChange0n6() 
set s to 111 
set b to 121 

set myLiist to la* bl 

«et nballowCopy to Items of myList 

set Item 1 of myList to 0 

return (myList is equal to 10* (21j) and (a i 

is equal to 111) and (shallowCopy is equal to 
HI). 1211) 

end shallowCopyChangeOne 


Figure 11 shows what shal lowCopy kx>ks like 
when we create it on line 4 of 
shallowCopyChangeOne(). 



Figure 11: shallowCopy as created. 


Notice how Ixuh items of the lists share the same 
data, hut are two separate sets of items. You can really see 
this in line 5, where we set item 1 of myList to 0. 


ifiyLi St 


item 1 

Q 



Figure 12: set item 1 of myList to 0 
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Line 5 is setling what item i of myLisl points to. 
Since myList and shallowGopy are separate 
entities, and we did not change lire data shared 
between them (a), oiir change does not affect anything 
outside of myList. 

Lfnlike shallowCopyChangeOne (), wiiere we 
changed what item 1 of myList shares, shallowCopy 
ChangeSharedValue () changes the contents of an 
item shared between the tw^o lists. Watch and see: 

to shallowCopyChangeSharedValuG() 
get a to tl) 
set b to 12) 

set myList to la, bl 

set shaliowCopy to items of myList 

copy myList to deepCopy 

set Item 1 of item 1 of myList to 0 

return [myList is equal to HOi* [211) and 
[shallo>iCopy is equal to llOl* 121!) and (deepCopy 
is equal to Hi), t 2 )) ) 
end shallowCopyChangeSbaredValue 

Line 6 changes the value of (jrem 1) of a, wlikh is 
shared by both myList and shaliowCopy, Since 
shaliowCopy and myList Ixjth share the contents of 
a, the change is shown in both lists. 

Shallow copy only has an advantage when dealing 
with container items. Just like set, scalar items are 
duplicated, so there is no speed or memory gain for using 
a sliallow copy on a list of sailar values. 


Deep Copy 

A deep copy is when AppleScript duplicates all of 
the data inside a container type. This means that both 
iisLs duplicate each other's data, and modifying even 
the contents of one will not affect the other, because 
there is no siiaring going on at any level. You can deep 
copy a list by using the copy to syntax: 

copy myList to deepCopy 

Since deepCopy is a copy of the values in 
myList, we can change one list without affecting the 
other in any way. 

to deepCopyChaugeOne[) 
set a to 111 
set b to 121 

set myList to ja, b) 
copy myList to deepCopy 
set item 1 of a to 42 

return [myList is equal to 11421, {211) and (a is 

equal to (4213 and [deepCopy is equal to [(ll« 

12 11 ) 

end deepGopyChangeOne 

Line 4 of this handler duplicates myList, bit for 
bit, creating deepCopy. Figure 13 illustrates what 
myList and deepCopy look like on line 4. Line 5 of 
this handler change.s item 1 of a, A*s data is shared by 
myList, but not by deepCopy, thus the changes are 
not reflected. 
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Figure 13; myList vs deepCopy 
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Our test framework’s twiddleCopy 
ListltemList () shows that one am diange a scalar value 
in one list and liave it reflected in the deep copied lisL 
twiddlc'CopyListltemListO is a more complex example ol the 
siime topics shown by deepCopyChangeOneO 


duplicated all data), but ciianging item 5 of 
myList is reflectcxi by lx>tli myList and 
shallowCopy, because that value was shared 
by variables. 

Copying and scalars 

As discussed earlier in the article, care 
should be taken to rememlxrr that, that set 
performs a deep copy on scalar items. 

Conclusions on Types of Copy 

So when do we want a shallow copy, and 
wlien would we prefer a deep copy? In 
situations requiring s|>eed, or recursion, a shallow copy is 
probably your best bet. A deep copy is useful when your 
.script is going to l>e changing values of a list, hut you 
need to leave the original values intact, Duf^licating all this 
data has a price, and scripters must l>e aware what exactly 
copy is doing, why it takes so long, and the alternative. 



to twlddleCopyListltemLlst 0 

a to 1 

set myList to tfaj, tal, tsK laK lall 
copy myList to deepCopy 
set shallowCopy to items of myList 
set Item 1 of item 4 of deepCopy to 42 
set Item I of item 5 of myList to 23 

return (myList ts equal to (UK (U* (H* tlK 

(Z3M) and (deepCopy is equal to ftlK ilK tlK 
(42 [, 111!) and (shallowCopy Is equal to MIK ill. 

UK Uf, E23II) 
end twiddleCopyListltemList 

See how changing tile contents of item 4 of deepCopy 
dcx;s not mexiify myList (because deepCopy has 
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Conclusion 

Tlds article has covered a for of ground. From Icamiiig tlie 
tliree different cbssific'ailoas of AppleScTi|>i variable types 
Csailar types, c'onLiincr types, and examining the reference 
lyfx.‘ in detail), examining the different ways ol' ap[x:'nding 
iteias to a list, to picking tlie correa ctipy iy|x.* for tlie oonea 
situation. Even without interacting with applications, 
AppleSc'ripi Is a kmguage with a lot of power^ and (like rod 
world human langLiages)^ different ways to express ccmcepLs. 
iiy undefKLinding these aincepLs, tlie lx*st ixxssible solution 
am be chosen, and your scripts can tun Ixtter and faster A 
(‘aster saipl nxiins everybody wins: the saipier, die end users, 
and tlie twenill system. Happy Scrripiing and Ixst of luck on 
your further AppleSciifU projects! 

References 

AppleScript Language Guide, Apple Computer; 
http://developer.apple.eom/doaimentation/AppleScript/Corrceptual/A 

ppleScriptLangG uide/ 

AppleScript: The Definitive Guide, Matt Neuburg, ISBN: 0-596- 
00557-1: 

http://www.oreilly.com/cataloa/apple5cpttdg/ 

'llie author would like la take the time to thank (in 
alphalx-'tical order): Jared Barden, Mami.sh Sanderson, and 
Matthew Str:mge for their review and leehnieiil insights 
during the creation t>f this article. 


About The Author 

Rym Wicox b ihe fomder a/ Whx [hvdopment S<A>tiom (www,¥th>x(Lcom) 
spedafoing m cmimiatm, mtss-fAtthnn api^atm devdopmenf mid e- 
€(mmief(e sd&fkm* VMekamg msdytawankfytlmfoltfhed^ 
get away fa use AppkSoft He mk readied at rwihx@w^xicm 

WWW.MACnKH.COM 




























Taming the Tiger 



SpiderWorks 

From our brain to your brainl 

Timely, quality content from 
respected authors at a great 
price. Available in softcover 
print editions and eBooks. 



For more inforinatiott 'ifid to order oni 


www.spiderworks.com 











Storing and Accessing 


Data with AppleScript 


n last month’s column, I provided an introduction to 
Database Events, a new technology that made its debut with 
Mac OS X Tiger. I discussed how Database Events can be 
used as a method of data storage and retrieval by allowing 
AppleScript to interact directly with SQLite databases. 

In this montli’s column, I would like to discuss some other methods 
of storage and retrieval, such as accessing properties directly within 
scripts, or witliin property list files in the operating system. 


Script Properties 


The first mecli;inisni for d;ita storage iliat 1 
would like to address is a script Imjperfy. Wlien 
scripting an applicaiion, many times, a class 
within that application will possess properties, or 
attributes that are accessible through AppleScript. 
For example, in the Finder, the disk class 
pcxssesses a number of properties, including a 
name* capacity, and format* When writing a 
script, you can define properties for your script 
itself. A script property is defined within a script 
using the following syntax: 

property propertyName : 4:Property Valued 


For example: 

property theUserName 


‘bwaldie" 


Script properttes may he defined anywhere 
within the top level of a script (or a script 
object). Once a property has been defined, it 
becomes global in nature, and is accessible bf.)th 
throughout the top level of the .script, as well as 
throughout any handlers in the script. 

For information about script objects, 
please refer to the AppleScript Language 
Guide at: 


http://develoDer.applac(3m/documematian/AppfeSaipt/ , 

When a script property is defined, its value is 
officially as.signed when the script is cornpiled. This 
means that there is no need to define a value for the 
property, as you woiild a variable, witliin your script's 
executable code. Rather, you may immediately begin 
referring to the profierty. 

Script properties are accessible in the same way that 
variables are accessible. You may get the value of a 
property and you may set the value of a property in the 
same way that yon would do with a variable* LInlike 
local variables, however, properties are global in nature. 
This means that the property i.s acces.sible at any level 
of a script - at the top level, and also within any 
liandlers. For example, after defining the property in 
the previous example code, the following code would 
be valid executable code at any level of the script, and 
would not generate an error indicating that 
propertyName is not defined. 

display dialog propertyName 

Properties also retain their most recent values 
between script executions, and will continue to do so 
until the script is recompiled. This makes properties 
an idea) mcclianisrn for storing and retrieving data, .so 


56 


March • 2006 


WWW.WACTECH.COIVl 




















y 


long as ilie .script docs nui need to l>c frecjiicntly 
recompiled. 

Working with a Property in a Script 

Let's tiike a look ai a propeity in action. 1'lic following 
example cxKle demonstrates how a property can Ik* used to 
sUjre a persistent value betwi^en script executions. 

property iheRuriCount : 0 

set theRunCount to th^RunCount + 1 

display dialog "This script has been run ** & 

theRunCount & ** tiiue(s)." 

If you run (he previous code in Script Hditor, the 
first time the script is run, a dialog will be displayed 
indicating that the script has been run one lime. If you 
then run the script again, the dialog will indicate that 
the script lias been run two Limes. Tf you run it again, 
the dialog will indicate that the script has l)een run 
three times. 1'his will continue indefinitely until the 
script is recompiled. If you do recompile the script 
and run it again, the script will start over, indicrattng 
that if has been run one time. 

Tt> tgiic:kly recap what is occurring in this code, the 
first line of the script defines a properly, named 
theRunCount. 'Fhe second line changes (iie value t>f 
the property by incrementing its value by one. I'he third 
line displays a dialog riiessage that includes the new 
property value, 'rhis new property value is then retained 
l)y the script until the next execution, when it is 
incremented again. When the script is recompiled, the 
original value of 0 is re-assigned to the property. 

Properties are a great way to store information such 
as commonly requested hie or folder paths, usernames, 
run counts, last execution dates, and more. 


IMPORTANTi Please Ik aware that properties that 
are assigned in AppIeSciipt Studio projects are NOT 
persisleni between script executions. 


Working with a Property in Another Script 

Now Uiat we have discussed storing and accessing 
properties within a script, let's take the concept t>ne step 
further — storing and accessing properties in another 
script. First, create a new document tn Script Editor, and 
enter the following code; 

property theRunCount : 0 

Next, save the script to the desktop, and name ti 
Froperties.scpt. Now, create a new Script Editor 
dtKumenl, and enter the ftillowing ct)dei 
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set thePropertyScriptPath to (path to dc^^ktop 
folder as string) & ^'Properties, sept" 
set tbePropertyScript to load script file 
thePropertyScriptPath 

set thePreviousKunCoiint to (theRdnCount of 
thePropertyScrlp t) 

set theNewRnnCoiuit to theProvlousRunCount t 1 
set theRunCount of thePropertyScript to 
th et) e wEuti C o unt 

store script thePropertyScript in file 
thePropertyScriptPath with replacing 
display dialog "This script has been run " h 
theNewRtinCount & “ time(s).** 

Now save ihis second sen [it to the desktop, and name 
it External Ran Count.scpL See figure 1. 
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set theRunCount of ihePropertyScnpt to iheNewRun Count 
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property theRufiCount: 0 
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Figure 1 p Accessing a Property from an External 
Script 

it you run tlie External Run Countstpi sc:rif>l iiiLiliiple 
times, you will encounter behavior similar to that of my 
earlier examples. Ihe script will dLspby a dialog inciiraiing 
how rrumy times the sc ript has been triggered. However, this 
value is not !x.ing sloied iitlemalJy. Ratlier, it is lieing stored 
externally in another script. 

In the example above, the external script. 
f^operties.scpl, is lx:tng loaded by tile script Exlemat Run 
CounLsepi. The value of the property theRunCount is 


l^eing retrieved, and changed within the k>aded script 
The modified It jaded .scripl is Uicn l:)eing stored back into 
its tmginal file, ft)r the next execution. 

There are many benefits to utiii?:ing properties in 
this manner. Let's say, for examjile, that you have a 
script that you have created and saved as a nm-only 
application. However, you want others U) have the 
ability to change certain l>ehavioral aspects of that 
scripL You could create properties that control those 
behaviors, and store them in a separate, editable 
script. Then, your main scripl could load and access 
those properties as needed, during execution. 1 use 
this technique frequently when delivering scripts that 
may nor have configurable user interfaces to clients. 
While die main ct>dc of my script may be locked, the 
client usually has the ability to change certain aspects 
of how the script behaves by modifying properties in 
an external script ‘‘settings" file. 


Property List Files 


The next mechanism that 1 would like to discuss 
for data storage and retrieval is property list files in 
Mac OS X, a.k.a. pLisi files. Properly list files are XML- 
based files, which are utilized by many applications 
and processes in Mac OS X for .storing and retrieving 
information. 

tn the past, J have mentiemed an application named 
System Events, which is ItKated in the System > Librar}^ 
> CoreSennees folder in Mat’ OS X. System Events is a 
background application, which provides scriptable access 
to many aspects of Mac OS X. With the release of Mac 
OS X Tiger, Apple has intrcKluted a new .suite cjf 
terminology inu> tire Sy.stem Events application - a 
Pn^perty List Suite. See figure 2. 
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Figure 2. System Events' Property List Suite 
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Tlie Property iJst Suite In System Events provides 
AppleScript with a way to retrieve and modify values 
within property list files. 

Creating a New Property List File 

Before getting started with the actual scripting 
terminology, let me first mention creating pn>pcrty list 
files. UnfonunaLely, at present, System Events does not 
provide a way to create ]>rt>i>criy list files via AppleScript. 
Tile intention at this point is to provide a way Rjr scriplcrs 
to interact with existing property list files. 

1‘hat said, inevitably, AppleSc:ripiers want the 
al)ility to create property list files. So, until that 
functionaUiy is Imili into System Events (assuming it 
will he at some point in the future), here is some 
example code for creating a basic property list file vvitfi 
AppleScTii>i^ The code below will write the base XML 
of an empty prO[>erty list file to a new text file on the 
desktop. Feel free to adjust this code as needed in 
order to meet your specific needs. 

set r.heKmptyPLiatUata to “CTxmi verslon“\"l ,0\'' 
erTcotiing=V'llTt" S\''?> 

<!DOCT¥FE plist PUBLIC V**-//Apple Computer//UTD 
PLIST 1*0//EN\*' 

: //www. apple ,com/DTOE/PropertyList 1.0. dtd\*‘> 
<pllst verslon-\n.0\‘*> 

<dlct/> 

set theOutpurFolder to parh to deskrop folder as 
SI irlTig 

aet LhePListPath to theOutpUtFolder & 


*’TiiyPLlatF±le,pllst“ 

set thePListFile to opes fox access thePListPath 

wltL write permissioii 

set eof of thePListFile to 0 

write theEmptyPListData to thePListFile starting at 
GOf 

close access thePListFile 

Adding New Properties to a Property list File 

If you need to generate property list files tlirough 
scripting, then you probably also need the al:>itity to 
add new properties to diose files. Again, Vm sorry to 
say tliat, unfortunately, this is not the most straigln- 
forwarcl prcjces.s witli System Events. As nieniioned 
previously, System Events is intended to provide a way 
for you to be iible to access and nK)dify existing 
properties. At present, ti is nor really intended for 
creating property list files or adding new properties. 
However, there is a way to do it, and here it is. 

In System Events, the Property List Suite consists 
of two classes, a property list file and a 
property list item. The property list 
file class lias a contents property, which consists 
of a property list item class. This property 
list item class possesses kind, name, and value 
properties. Out of these, value is the only modifiable 
property. To add a new properly list item within the 
txjntents of a property list file, you need to set the 
value of this property list item to an AppleScrij)i 
record. This AppleScript record mirst consist of one or 
more field names and values, which correspond to 
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XML keys and values, respectively. For example: 

sot theOutputFolder to path to desktop fold&r as 
string 

set thePLlstPath to POSIX path of (theOutputFolder 

& ^'myPLlstFile.pllflt**) 

tell application “Systoin Events" 

tell property list file thePListPath 
tell contents 

set value to I |keyname | : "keyValue** I 
end tell 
end tell 
end toll 


After ailining the code above, a new f>ropeiTy would 
be generated as XML witiiin die referenced property list 
file, and would appear as follows: 

<dict> 

<koy>key Naiiie< /key^ 

<string>keyValue</s t ring> 

</dict> 

You can also use a similar iecbnit[ue to add to 
property list files tliai already contain existing properties. 
The hallowing example cocie demonstrates htw this can 
Ik* done. 

set theOutputFolder to path to desktop folder as 
string 

eel tlmPLlstPath to POSIX path of (theOutputFolder 

£1 "myPListFile.pllst") 

tell application "Systeni Events" 

toil property list file thePllstPath 
tell contents 

set previousValue to value 
Bet value to (previousValue b 
I |keyNanie2j ; "keyValuc2** I ) 
end tell 
end tell 
end tell 


In the example code alx^ve, fivsl, the existing value of 
ihe proixirty list filers content is retrieved. Next, a new 
AppleScript record is appended lo Lhtil value. The revised 
value is then reapplied Lo the propeity list hie. The 
resulting XML of the (iropetty list file appears a.s hillows: 

<dict> 

< key > key Name* < / key ^ 

<string>keyValues/string> 

Ckey>keyName2C/key> 

Cstring>keyVaiue2C/string> 

</dict> 


In the previous two examples, 1 have demonstrated how 
to create pioperty list items tliai ctjntiiin string values. There 
tire otiier types of values tliat am lie created in property list 
fries, including lxx>le;ins, dates, lists, fea>rds, etc. Here, is 
anoilier ex^tniple of code that will apjKnd a new property to 
a projierty list file. Tliis lime, a record will Ik added. 

set theOutputFolder to path to desktop folder as 
at ring 

Bet thePListPath to POSIX path of {theOutputFolder 

& “myPListFile.plist*') 

tell application '’System Events" 

tell property list file thePListPath 
tell contents 

set previousValue to value 
set value to (previousValue & 

I}keyName3|:(subKeyNamel:”subKcyValue!", 

^iuhKeyValue2 : "subKeyValueZ" f 1 ) 
end tell 
end tell 
end tell 

The atove example ctxle would change the contents 
of the property ILsi tile 10 appear as follow^s: 
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<dict> 

^key^keyNamekey^ 

CaxringS keyValue</Eti:ing> 
<key>keyNam€2<ykey> 
<Btr±ng>keyValue2</st-ting> 
<key>keyName3</key> 

Ckey^subkeynamel</key> 
<string>subKeyValuel</sL ring> 
<key>subkeyvaliie2 </key> 
<string>subiCeyValue2</sti:±ng> 

</dict> 


Modifying I^operties in a Property list File 

Once properties exist within a property list file* 
(he values of these properties may be modified using 
System Hvents. The following example code 
demonstrates liow to modify the value of a property 
that was created in the previous example: 

set iheOtit put Folder to path to desktop folder es 
string 

set thePListPath to POSIX path of (theOutputFolder 

& ■*myPListPile*pllst-) 

tell application "System Events" 

tell property list file thePListPath 
tell contents 

set value of property list item "keyName" to 
"New Key Value" 
end tell 
end tell 
end tell 


Once the specified property has been modified, its 
new value will l^e rellected immediately in die property 
lisr file. For example: 


<dict> 

<key)'keyNa(iie</key> 

<string>New Key Value</Sttlng> 
<key>keyName2</key> 
<string>keyValue2</ st ringl> 
^key^keyNameS^/key> 

<dict> 

^key ^subkeynamel^ / key?^ 

< st rin g> s ubKeyValue1</st ring> 
<key^subkeyvalue2</key> 
<string>£ubKeyValue2</string> 
</dict> 

</diot> 


Likewise, property list ilems contained within other 
property list items may also he modified. In doing so, you 
must be sure to refer to these property list items within 
their proper containment hierarchy. The following 
example code demonsirates !iow to change the value of a 
projierty list item within anotlier property list item. 

set theOutputFolder to path to desktop folder as 
string 

set thePLiatPath to POSTX path of (theOutputFolder 

& ’‘myPLlatFile. plist") 

tell application “System Events** 

tell property list file thePLlstPath 
tell contents 

set value of property list item "subKeyNainel" 
of property list Item "keyNamel" to "Now Key Value" 
end tell 
end tell 
end tell 


After running ilic previous code, (he property list file's 
content would appear as follow's: 

<dict> 

<key>keyNaroe</key> 

^string^New Key ValueX/string^ 

<key>keyName2</key^ 
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<Btrina>keyValue2<ySt ring> 

<k«^y >keyNaine 3 < /key ^ 

<dict> 

<key>subkeynamel</key> 

<string^New Key Value</sTrliig> 
<key>subkGyvalue2</key> 

<Btring>3ubKeyValue2 C/string> 

</dict> 

</dlct> 

Retrieving Properties From a Property 
List File 

As you mi^hi expect, retrieving a property value 
from a property list file is relatively straightforwarcl, 
Ft)r example: 

set tbeOutputFolder to path to desktop folder as 
string 

set theFLlstPath to POSIX path of (theOutputFoldet 

& “myPListFile-pllst*') 

tell application '‘System EvenTs'" 

tell property list file thePLlstPath 
tell contents 

value of property list item '*keyNaroe" 
end tell 
end tell 
end tell 

—> ''New Key Value" 


One thing that I do want to stress is, when working 
with property list files^ you do not need to access only 
property list files that you liave created. You may actually 
use System Events to retrieve and/or modlly the values of 
the properly list files of other applieiitions or piXK'esses. 

For example, the code below demonstrates how to 
retrieve the value rt)r one of Safari's preferences. In 
particular, this code will retrieve the value of the 



AlwaysShowTabBar preference, which indicates 
whether the tab [>ar should be displayed in Safari, 

snt thePLlstFolderPath To path to preferences 

folder from user domain as string 

set thePListPath to thePLlstFolderPath & 

‘'com, apple .Safari .piist" 

tell application "System Events" 

tell property list file thePListPath 
tell contents 

value of property list itetn 
"AlwaysShowTabBar" 
end tell 
end tell 
end tell 
“> t rue 

storing Properties in an AppleScript 
Studio Project 

Next, rd like to u>ych briefly on AppleScript 
Studio. Earlier, I mentioned that AppleScript Studio 
does not have the ability to store persistent property 
values between script executions. However, in many 
cases, this may not be necessary anyway. The reason 
for this is l)ccause AppleScript Studio actually provides 
terminology for accessing properties in the 
application's property list file directly. This is done by 
accessing the user defaults class of the 
application class, which may contain default 
entry classes as elements. These default entry 
c!as.ses may be created and modified w'iiliin the context 
of the user defaults class as needed during the 
execution of your script. Once the application (juits, 
any default entries wifi be written to the propert>^ list 
file for the application, where they will be accessible 
the next Lime the application runs. 

iTie following example code demonstrates how user 
defaults and default entries m;iy be used io store infonnation. 

on launched theDhjeet 

if (default entry "theRunCount” of uaer defaults 
exists) = false then 

make new default entry at end of default 
entries of user defaults with propertlGS 
I name;"theRunCount", contents 101 
end If 
Idle 

end launched 
on idle 

set TheRunCouni to contents of default entry 
"theRunCount" o£ user defaults 

set theNewRunCount to theRunCount + 1 
display dialog "This script haa been run “ & 
theNewRunCount & " timeCs) 

set contents of default entry "theRunCount" of 
user defaults to theNewRunCount 
quit 

end idle 

In {he on launched handler alxjve, an if 
statement is used to determine whether a default entry 
named theRunCount already exists in the user defaults. 
If it does not, then it i.s created with an initial contents 
value of 0. 
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When I he on idle handler triggers, the run count 
default entry is retrieved from the user defaults, 
incremented, and displayed in a dialog. The incremented 
run count is then applied back to die appropriate default 
entr>^ in the user defaults. When the application quits, tltis 
information is stored in the propeny list file for the 
application, 'llierefore, if tliis applicaiit)n is triggered 
multiple limes, the mn count value will continue to 
increment with cnich new exec'ution. 

I l.ser defaults piovide yet anotlier way to store and access 
data during scrtpi execution, tliough only in AppleSc:ript 
Studio projects. 

Other Options 

i w^oiild like to also take a moment to mention that 
there are other ways that you may chQO.se to store and 
retrieve data, should you decide that the methods 
mentioned previously do nt>L meet your needs in a 
particular situation. One w^ay is to store data in a standard 
text file of some lype. Typically, a delimited format of 
some type makes a gocxl choice, although tt may require 
that you write some fancy parsing ctxle. Another choice 
could lx* to store your data in a datalxise, such as 
FileMaker Pro. If youTc using Mac OS X 10.4 or higher, 
then you could also consider exploring Database Hvents 
further, which was the topic of last montli's cokimn. 

In Closing 

ilopefijlly, 1 have Ix^en able to provide some insight 
into several possible methods of data storage. Obviously, 
you are certainly not bound to make use of only the 
techniques that I discu,ssed. ITiere are odier mechanisiivs, 
which I encourage you to explore. However, the 
tcchnicjues that I have mentioned are die most commonly 
iKsed among scripters, and generally do provide you with 
a variety of relatively quick and easy ways to store and 
retrieve data using AppleScript. 

Until next lime, keep scripting! 

All 
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Web Surveys: 
Quick and Easy 

Have you ever needed to do a survey, c|uick ... but you 
didn't have time to go anci custom axle it for yourself* Recently, 
we had this need at MacTecIi ... you may rememl:>er a recent 
reader survey. We looked around and came across a neat 
prtxlucl allied phpQuestionnaire (or phpQ for short). 

phpQ installed really easily on our 5^rve running Mac OS 
X Server, and took advantage of our PHP 4 and mySQL setup. 
Tile installation instnictions were a breeze, and the interface was 
fairly intuitive. 



‘iTiis prcxluet gives you a very detailed, web-basetl survey 
ability. The admin of it is, as you would expect, all well based, 
and the question editor is fast and easy to use. Only once in 
creating a sun^ey did I pause to figure out how to do someihing. 

You can run multiple suiveys simiiltaneously and tlie pli|iQ 
takes care of tracking tilings .separately. And, Ixicause it's template 
driven, you can change tlie l(x>k and feel if you so desire. (Akliougli 
if you are lazy like I was lieing, you pst Like advantage uf tlieir 
prolessional templates ... after all, it was just a survey!!) 

Iheie are many dilferent question types, and you can create 
surveys with all kinds of conibinittions. Everything 1 needed, it bid 
liuill it... radio buttons, check lioxes, text lioxes, text areas, etc.,. 

You can use some simple restricUoas or l:se more advanced 
... to avoid lx>gus data, or duplicates* Unique IPs, c<M>kie.s, and 
email verifications are all an option. 

One of the nicest features of tills pnxtua is it's ability to 
"preview” an entire survey Ix^fore you publish it. It helped with 
layouLs, gniupings, page layouts and ordering. Again, it was fast and 
simple ... and by just opening the .survey in a separate window, I 
could edit the survey in one window, while viewing it in another. 

Onc'e your u,sers have entered tlie infbnmtion, you can then 
view tJie results in a summarized, derailed or individual manner. 
And* as you would expect, you can export tliese tesuhs as well* 

If you want ifie pulilic to review the results, they on .*. or you 
can keep tliem private. Your choice. You can also get notifications 
to admins when people are doing the survey. 


liecause this is all based on mySQL, you can go into mySQl 
and poke around if you'd like. But, witli backup and restore 
features in phpQ, and the ability to export, iliere's really not 
much reason to. 

chumpsofi has done a bang up job here witli 
phpQuestionnaire 2.Z* Ihe full version is $199, and diere's a 
junior version for $59 along with some other flavors, 
ht tp://www.chtimDSoft.com/ 

7itl 


Snapz Pro X 2.0 


Move ahead of using static screenshots for conveying an 
idea effectively and take full motion video screen captures and 
create screen atsls with Snapz Pro X 2.0. Snapz Pro X 2,0 is a 
great (and easy to use) screen capuire utility for capairing 
moving or still pictures on Mac OS X. 



Snapz Pn> X 2.0 captures full motion vidix) of anylJiing on your 
Mac screen, along with digiral audio and an optional miaophone 
voice over at the rate of 30 frames per second in millions of allots. 
Snapz l^ro X 2,0 is dlectively a digital video tumcra, wliich allows 
recording anytliing on your Mac .scTuen and saving it as a QuickTime 
movie or screen shot. A n^al-time preview of the screen cast Is 
available. Scieen atsts c':in also Ine saved in a QuickTime compatilile 
video compression formal to ofiiimi/r for data rate, frame rate, and 
color depth for creating smaller size videos. 

Snapz Pro X 2.0 really simplifies such tasks as producing 
product demos, creating tutorials, making training videos, and 
archiving .streaming video, tf ytiu are the type that wants to, you 
could even u.se Sna[)Z Pro for showing their peers liow good a 
game is or how to use an application. .Snapz Pro X 2.0 features 
a completely redesigned interface for providing powerful 
feature.s while maintaining elegant simplicity of Snapz Pro X. 
Snapz Pro X was completely rewritten for Mac platfonn. 

If you are just looking For .static .screen captures, Snapz Pro 
X 2*0 packs in numenms new features* "Live Preview” Ls one of 
tlie most powerful and time saving features, which shows you 
exactly how' your screen shot will kxik liefore you save it to 
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disk, allowing on the fly cliange in bfirder styles, scaling, 
cropping, and other settings. Another vcr>' usc‘ful feature is 
"Tathits^' tool that allows zooming in on the pixels on your Mac 
screen for automatically general ing image tiiumbnaiLs. 

Screenshots can be scaled, crtjpped, trolor depth-t^hanged, 
and dithered. Snapz Pm X 2.0 can also add Ixjrders, generate 
automatic thumbnails, and overlay waiermarks/copyright notices. 
Snapz Pro X 2.0 uses Anibrosia's proprietary Clearscale 
technology' to stale images up or down for bodi static images, and 
screen casts. Snapz Pro X 2.0 supports saving stTeeri shots as 
.bmp, pict, .gif, 4pg, .png, .tiff, .|xlf, or Photoshop tiles, with 
precise contr<yI over image coin[Drcssion levels and cok>r tiepth. 

Snat^z Pro X 2.0 costs $69 (screenshot only version [triced 
at $29), with upgrades from Snapz Pro X 1.0 w/ movie capture 
priced ai $20. Snapz Pn> X 2.0 requires Mac OS X 10.2 or later 
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Klear Screen 

The Right Way to Clean Your Screen^ 
iPods, and More-.^ 

If youVe bix^n kx)king for a way to dean your LCD, pkesma. 
111/IY, Hat stTeen, and CRT displays, then you may want to take a 
kx)k at the prtxlucts i?y Klear ScRxrn. Klear Screen has designed, a 
set of prcxlucLs specifically to clean, proteci, and polish all Apple 
displays and iP<xls, in atidition to laptops, especially X-Briie or 
Crystal Gear Seteens, new Generation LCD screens, plastna and 
HDTVs, digital cameras, aixl camconders, 

Klear Screen prcxlucts contain a 3-step Liquid polymer-based 
formula tltat lifts and cfi.ssolves surface contaminants and 
fingerprints, and floating tlebris off llie screen surfatx, leaving an 
anti-siatit' coaling. The coating, significantly reduces .surface 
friction and wear, resists fingerprinting, and provides a 
renewable protective .seamen barrier. Klear Stxeen prtxiucts are 
non-loxic, and alcohol and ammonia free. 

Kleai Screen Deluxe Cleaning Kit is die recommendcxl 
.solution for your cleaning ret|uirernenis, Kle:tr Screen Deluxe 
Cleaning Kit casts $ 24.91 It includes: 


D 8 oz. Klear .Screen Pump Spray 
1* Large Micro-Chamois Polishing Cloth 
6- Klear Kloths 


Klear Screen 
products tlial are a 
part of the Klc^ar 
Screen Deluxe 

Cleaning Kit, are also 
available individua I ly. 
'Itie Klear Screen B 
ox. Pump Spray 
Bt)ttle that lasLs for 
approximately 1,200 
cleanings, costs 
$12-95. Klear St'feen 
Micro-Chamois 
Pnlishing Cloth, 
priced at $9.95, is a 
lint free, non- 
damaging, washable, 
and reusable cloth. 
Klear ^ScTec^ Klear 
Kloths, also priced at $9.95, are made from lint-free, non- 
polyester, white-room, aerospace grade, non-woven polishing 
material that can be used and re-used for weeks al a lime. Klejir 
Screen Travel Singles are designed for the needs of individLials, 
who need a quick and easy-to-use cleaning solution whether at 
work, home, or in the classrcxmi. Klear Screen Travel Singles cast 
$9-95. A pack of 3 Travel Size Micro-Chamois Polisliing Clotks is 
priced at $9-95. Otlier produa.s of the Klear Screen mnge include 
Klear Screen High perfomiance Kit. Klear Screen Super Staner 
Kit, and Klear Screen MicroFiber Polishing Cloth. 

MacTeclTs staff has lx:en using Klear Screen products for 
years, and gives them a “two rhumbs up”. For more information, 
see http://wvvw.kiearscreen.comf 


- by MacTech Staff 


2- Klear .Screen Travel Singles 
1- Travel Size Micro-Chamois 
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Klear Screen Deluxe Cleaning Kit 
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Valentina 2: Deploy True, Royalty Free Client-Server Solutions 

www.paradigmasoft.com 





















Olfter iVoifif Computing 


Serving the Mac Universe since 1988 

visit inacsales.cofn 800.275.4576 


SuperDrive Your Mac 
From Only $52.99! 

Make Music, Movies & More 
Adda Fast SuperDrive to your 
Mac to Burn CDs, DVDs, even 
8.SGB Dual Layer DVDs! 




Internal 8f 
External Options 
for nearly EVERY 
Apple Laptop & 
Desktop madel 






Macworin 


fW 






Ext^nal Tar arty Mx (or 
PQwiWi 

FlreWrf AJSft 2.0 port. 


You can use Apple's iDVD, 
iPhoro, ITunes, Discburner, 
etc; Roxto Toast; nearly 
any CD/DVD authorizing 
software available! 




media, tas€j & labeF 
kits in siocUciol 


nfiacsales.com/superdrive 








Not sure what upgrade is 
best for your computer? 


Then visit My owe 
MMnum" Upgrade Center and 
M 0 mW WM buy with confidence! 

macsales.com/MyOWC 


Memory 

More Memory for a Faster Mac! 

From the min to the Max - OWC has the 
right Memory for your Apple. 

For NEW 2006 MacBook Pro 
and iMac Intel models: 

PC5300 DDR2 667MHz 200 Pin 
512MB Modules only $59.99 
1.0GB Modules only $119.99 
2.0GB Set only $239.00 

For PowerMac G5 and 
iMac G5 Models: 

512MB DIMM from $49.00 
1.0GB DIMM from $92.99 
1.0GB Pair (512x2) from $95.00 
2.0GB Pair (1GBx2) from $185.00 
2.0GB DIMM from $249.00 
4.0GB Pair {2GBx2) from $495.00 

For PowerMac G4, iMac G4, 
eMac G4, Mac mini: 

256MB from $25.00 
512MB from $49.00 
1GB from $89.99 

For PowerBook 12/15/17; 
iBook G3/G4s: 

512MB Modules from $49.00 
1GB Modules from $115.99 
2GB Sets from $229.00 


Lifetime Advance Replacement Warranty. 


Call 800-275-4576 or 
visit www.macsales. 
com/memory and use 
our online guide 
to get the right 
memory for your Mac! 
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Hard Drives 

Internal Hard Drives 

Bulk up yaur computer by giving it NgKer capacity 
to perform for your needs. 

For iMacs, eMacs & PowerMacs 


Highly Reliable, High-Performance, Plug & Play 
- FireWire & USB2 External Storage Solutions 

Add up to 1 Terabyte - lOOOGBs - for your Audio/Video, Backup, Music, Additional 
Stora 9 e Needs, etc with a top rated OWC or NewerTech Storage Solution* Exciusrvely 
using the latest Oxford Chipsets and the the latest Hitachi and Seagate drives, these 
solutions are built to last, AM solutions are EMC/Dantz Retrospect Backup Certified and 
backed with up to a 2 Year OWC or NewerTech Warranty. 


3.5" Plug* 
^fiPlaySOGB 
^ to SOBGB 
^from $59- 


OWC Mercury Elite^AL Pro up to SOOGB 
FireWire 400-I-USB2 Solutions from $129.99 
0^ B reWi re 800/400 Sol utio n $ fro m $149.99 

FireWire 800/400/USB2 Solutions from $159.99 
m Add your own HD Enclosure Kits from $79,99 

owe Mercury EMte-AL 800 Pro RAID up to 
PI ITBfIOOOGB) 

^1 FireWire 800/400 Solutions from $239.99 

^ Add your own HD Two-Bay Enclosure Kits $119.99 

MatwarH L AY E R S 
W Wtl mmmmm 


For PowerBooks, iBooks & Mac mini 


2.5" 40GB & / 
upto160G6 ^ 
from S79.95r* 


Not sure what 
your Mac takes? 


Buy with Corifiden<e, call or 
u$ti ouf onttne guides. 

maesa ■« xam/h arddrives 


OWC Mercury On-the-Go Portable up to 160GB 
FireWire 800/400/USe2 from $149,99 
FireWire / FireWire 400/USB2 up to 120GB from $129,99 
Add your own HD Enclosure Kits from $59.99 

Pholaahop User 

♦♦♦♦♦ 


■lard Drive Controllers 

Hard Disk Controller Card« 




Ber lal ATA 4-Chan rvcl PO M S7S.9S V 

!®NK*f m 

Tempo ATA & SATA Mac PCI Controllers ■ 

Tempo Trio Fi reWife/USB2/ATA 131 ^ 

ill in one PCI S149.00 

FirmTek 

4-Chflnnet SATA Controllers 

rom $119.95 ' ^ 

SATA Internal Mounting System 

bonnet G5 Jive, odd 3 SATA HDs to 
PowerMac GS S9S.00 ^ 

SATA External Enclosures 

FirmTek % 

Dual-Bay Hot Sw4p E itterrval Serla t ATA 
"nclosurc w*th SATA PCI Controlkf Card $257,95 

pNii*r 

jonnee Fusion 4 Bay SATA Kh $549.00 


The ONLY 
Focket-Sized 
Solution up 
to 160OB! 


Seethe full 
line of owe 
FireWire solution^r 
as well as solutions 
by LaCle, EZ Quest, 
SmartDisk, and 
Wiebetech online at 
ma e sa I es .com/FireWire 


I Siwtffs 

MacAddlci Mad-im 


Heptune 

FireWire 400 solutions 
from $99,95, Add your 
own HD Enclosure Kits 
just $47.99 


-lard Drive 
Enclosures 
me 

DWe MefcuryEhte 
>ATA RAID Solution! 
'erfeci U» I)lw5 Storage 
)r FlAID.CabiBS hvkidHl. 
Vi'drOWCWiinmy 

>[£ir(jn5 from 

579.95 


I OWC Mercury Elite Pro 'Cla$$ic' up to 400G8 
j FireWI re 400+USB2 Solutions from $129,99 
j FireWire 800/400 Solutions from $159,99 
! FireWire 800/400/USB2 Solutions from $169.99 
I Add your own HD Enclosure Kits from $79,99 


Seuroti I 

Bacioild „. 

****1 Mac/^dict 
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ADD FIREWIRE & USB 
to your Mac! ^ 

FireWire from $9.95 
FIreWire+USB Combos a 

from $29,99 


NewerTech miniStack™ V2 FireWlre+U5B2 Solutions 
with integrated FireWire and US82 Hubs bring high 
performance storage and port convenience with 
solutions up to SOOGB from $135,99 , 

Add your own HD Enclosure Kits $79.95 miillSti 

r.in EiJhiim Pwi CwmBclkw Swfcdi Swim^u Cbit 


Drive Genius .a 
Retail|99«9$|^65-® 

Maintains, Manages, 
Optimizes, Repairs. 
Keep your Hard Drives 
at their best. Recover 
data if disaster strikes] 


^ Macwqrtd 
Mag^rte 
OK«mlwi2WJ! 

Tap 7r«il»ct' 


Solutions include dll cables, Dantz Retrospect Backup. Intech HD Speed tools and are preformatted with free 
bonus software loaded all ready to plug and play your PowerMac, PowerBook, IMac, iBook, or eMac too. 


Prion, kpe«fio«tioni ^nd «rjiHiSilll jr^reMibltUlBdiingB without netict. Itonu roturaod wLlhlii 14 dayt inuf he sib^i Id a nitnchliFg fit. 
No retBria Will Nf «C0tptBd wirtioBI letUrn llertkinilru Authoriiflion ntttnher. 




























Mod your iPod 


From High Capacity Batteries to cases. Other World Computing has you covered in 
keeping your iPod looking stylish as well as getting nr^ore playing time. 

OWC's full line 

iPod Replacement Batteries 
& Enrichment Products 


/>> 


netxic>r»t:oi=liifniolagyi 


iPod Replacement Battery Kits 
^1 Easy to Install, Tools Included + Online 
j Installation Videos. Get up to 78% 

' more capacity & 20+ Hours Rurttimel 


iPod Batteries 
for nearly every 
Apple IPod 
Staffing From 

$14.99 


iPod cases 




Er--"^r 


Music on your Mac 

m a cs a tes .co mfm u sic 

M-AUDIO 



Mova Large StudioPro A Desktop 

Ca psu le Ca rd io id Ati di o Powered 

M icrophone $99.00 Mon i tors % 149.00 

•• =VAV// 




Mol comfortable 
opening /our iPodf 
For $39 + the cost of the 
battery,OWClnstalls it for 
you - IPod shipping Box and 
FedEx Overnight covered 
to and fromf 

macsales.com/rPod in sta II 

NuPower 





BoadTrLp! 

FM Transmitter 
For ALL Apple iPods 
Onfy 

S14.99 


Pay less. Get more. Surf faster! 


Mac-Only 

Internet 


from only 

5 


Tri gge r Fing er MIDI Ozone USB Audio 

Controller Input 8 Midi Controller 

Device $199.90 Knobs $249.00 


Shuttle A/V ControlJers 



Shuttle Pro v2 
I Jog/Shuttle 
+15 program¬ 
mable buttons) 

$84.99 




Shuttle Ej( press 
Jog/Sh little fS 
programmable 
buttons! $39.99 


1 High-Speed Nationwide Dial-up 
I and DSL Services 
I Toli-FreeTech Supports More 
I from Mac Experts 

Visit FasterMac.nel or call toll free 
800-869-9152 to learn more or to sign up. 


Apple OS X Tiger' $99.00 

fatl retoH box version 
OSX 1D.2,10.3 from SI7.99 




W Instant Music 
f for Mac $41.99 


EyeTV Video Encoder / 

TV Tuner/Digital Recorder 
$149.99 

EyeTV 200 $29S.OO 
EyeTV SDO High-Definition 
$339.00 







Apple iLife "06 
Make the most out of 
^your digital life. Share 
NEW! the magic of your 
ILife '06 ^ everyday with iLife 
gg. $79.00 pi' '06. Only $79.00 


GetaBcgger&Faster 
Hard Drive from $79.99 
MwEitorage ihat'i Hfi la 

Bum OVDs & CDs for only $119,99 
8X OVDBtiriKfti twin Appte'f cmrnl 

^ipeiCrm optm i 

Exclusive owe Online Video shows how to install these Mac mini 
upgrade;; or for $93 including ouemight pickup and return deliver/, 
owe will do the Mac mini upgrades for /oui 
Call or Visit macsales.cont/macmtni 

The Latest Enhancements 

Village Tronic VTBook 

Add another CRT or Fla.t Panel Display to /our 
ROWerb&OkS246.S9 

iLugger iMac cases 
for the iMac 05 or for Mac min i arid/Of up 
to 20' LCD Display 5 color combinations 
starting al$99.1>S 


Rain Design i360^ 
A Turntable for your 
IMacGS irand 30* 
$3^4.00 



Ev&cwidiicsrQi 

ytnifiW«Tni 

radiDoscfrbiti. 


0[ffiSPOS5Dffi]S 


mauit 


iW 


taar Qnfclnr Mac l^^rade Center 
















































Explore with your G4 


owe is the Apple Upgrades Expert! We know how to make your Mac 
a Faster Mac. And it's really amazing too - with a new processor, your 
Mac can be like new again - even better than new as it's possible for 
it to be FASTER than even a brand new Mac too. With 30 Days to try 
and a full 100% refund if it's not for you - you've got nothing to lose 
except that spinning beach ball. 


ATI MacEdition 
Performance Video Cards 

When your Mac is Fast, Don't let a 
SLOW video card hold you back! 


PCI Video Upgrade for Performance 
or Additional Displays; 

ATI Radeon 9200 
W/128MB for any 
Mac with an Available 
PCI Slot SUMS < 

Up to 2048x1536 
resolution. 

Compatible with up lo 24" 

Displays I 


owe Stocks the full line of G3 & G4 Processor- 
upgrades by these leading manufacturers: 




^RaoeonKi 

* - ^ 






e tij e r-1 eirtiiiij In 


G4 Single Upgrades from $195.00; G4/T.6GH3: only $249.00 
Or Crank it up as high as a Dual 1.8GHz for $595,001 


G4 Upgrades for PowerMac G3s, PowerMac G4s, 

Cube G4, PowerBook G3s - 

Even Legacy PowerMac 7200-%00 Models! 


macHOMi liKiMH] 

' liWi 


1 ^^ 


IJVliy UiBffrwJeT 

- More Speed for Less Cost 

’ Use all your existing memory, 
peripherals, etc. 

* Plug & Play and ZOOM 

- Works with the Latest Software | 
& OS X Tiger tool 

- Makes your current Mac (Ike 
new again! 


\ 

30 Day _ 

Money-Back ^ 

on NewerTech ^ 


"• and owe brand 
upgrades! 


High-Performance AGP Video 
Card Upgrades 
*AII of the following 
support up to 
two displays* 

ATI Radeon x800 
MacEdition 
with 2S6MB $449.00 
TOP OFTHEUNE6S 
VIDEO Card supports up 
to Apple's 30' Display' 

For PowerMac GSOnly. 


For all PowerMac G4 
Models: 

ATI Radeon 9600 S79,00 

Up to 256MD of High Performance 
Video Memory 

For 4X and 8X AGP G4,G5 models 
Support for up to two Apple 30' 

Cinema Displays! 

Quaru Extreme, Tiger Core Video 
Accelerated 

for Power Mac G4 Digital Audio, Quicksilver, 
Mirrored-Drive Door, and alt G5 Models. 


NEW! ATI Technologies 
RADEON 9800 PRO MAC 
EDITION $259,00 
Ultra High Performance Dual 
Head Video 
CardW/DVt,VGAanri 
S-Video Ports. 

256MB. New, for 
PowerMac G4s. 

Quartz Extreme, Tiger Core 
Video Accelerated 




Give us a call or 
check out our 
website. Our 
compatibility guide 
will show just what 
options are right to 
make your Power 
Mac, PowerBook, 


iMac, etc - a Faster Mac today! 
800.275.4576 macsales.com/Faster 


outer WorlU ComBuUng 

^mgti}eM(tcUmmesince M 

visit macsales.cam 800.275.4576 


1 , sfMdacaLbtti ABd wbjril to dungc wlHtvut notiw. Heins returned wlthla Vi days nly be object te a rttlochlni fee. 
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IN THE TRENCHES • by Schoun P. Regan 



Desktop Systems 


Engineer and Analyst 


I 


nterviewing Kevin Denges: Kevin is in charge of the image 
creation and deployment for Conde Nast. I spoke with him in 
New York City, at his office. 


Schoun: Kevin, tell me about the setup. 

Kevin: We liave a Windows Active Directory 
inirasirucnire for authentication. The Macs are lx)und 
to tlie Active Directory server and the X-serves are used 
as image servers, primary and secondary K4 servers. 
K4 is our Ado[>L‘ InDesign workflow. Each server is 
setup using 2 Xseive's, one primary and a second 
mirror for failover. We started all this willi Mac OS X 
103 . 3 , so weVe tieen at it for some time. 

Schoun: And for lile servers? 

Kevin: We are using Extreme zdp verskm 4. We 
started to depk)y them in Sepi/Oct of this year to our 
Windows servers, and by doing so, now Itjivc single 
sign on using Kerberos. 

Schoun: What ahoiii the Macs? How are they 
deployed? NelH(K)L^ 

Kevin: No. The Xserves are just image servers for the 
most part. We use FireWire drives to dejrioy our 
images, f>ut we also stt>re Uiose images on a serv^er. So 
if a tech ever needs to get a new^er image, they Ikxji 
off of a FireWire tlrive and insuill die latest image from 
our servers, 

Schoun: Scjimds like NetBooi may solve the booting 
from FireWiie issue. 

Kevin: We are lt>oking into dm, but for right now, 
FireWire drives are the most eMcleni for as. 

Schoun: So one image to n.ile them all? 

Kevin: Nope. We have an image that has all the 
software they need, and one main image. There are 
older images with 103 on them also. It dej^ends on 
where the computer Ls placed and witli whom as to what 
image they receive on tlieir Mac. 

Schoun: So the image build, IFs stcKk Mac OS X? 
Kevin: For the most part yes. We have leveraged the 
power of launclid to handle some initial binding and 
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computer setuf) for us, but other than lh;il, it's skxrk wilJi 
AcIoIx!'s CS2 suite. 

Schoun: Take us througli the launchd file. 

Kevin: Well basically it's very simple, it starts when the 
machine IxkjIs and runs a shell script that we have. Here's 
wliat it looks like: 
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Figure 1, 

Kevin: We also have another launclid item that handles the 
fixing of ByHost files. 

Schoun: First tell me al>out the AD binding launchd item: 
Kevin: As you can see, if run.s at lxK>t Lime, waits 2 seconds, 
Uien renices to get prelessor autlioriry, to run ahead of other 
items. It tlicn calls the shell script ADhook.sh located in a 
directory I chose. Pretty simple aciyally. 

Schoun: Is the ByHost launchd item die same? 

Kevin: For the most part yes, except it calls another script 
of course. 

Schoun: So lets look at the AD script tlien. We know^ that the 
Active Directory plug-in has a command line counterpart, 
dsconfigad. I assume you use this? 

Kevin: IPs now a small part of the script, but yes, it is the 
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Figure 2. 


integnil part. The .scripL is divided inu> four 
rmjt>r parts; network connectivity, AD binding, 
Byllast fixes, and file deletion. 

Schoun: Can we walk ihrotigh nsome of the 
major portions of the scripL^ 

Keviiir Sure, but keep in mind that some of 
this came from Mike Bombich's site, so credit 
goes to him for some of tliis. 

Schoim: ril let him know. 

Kevin: So as we can see, the first part of the 
script creates a log file for 
us to write to, then we 
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MySs’lpMnflg getjwcket l{Kt} J auk vdaHinjrwn / [print t3)‘- 

echo vbln/jfiite' %{Tat} - fua a uorch doMln for » AitirwyAdgB/All(VAOadln,tdaV 0 Klag 

It [ -z t{tJkS>]i than 

oaodcrlpt -fl ‘ady 'Iha kvvln DmIo Nsa rwl been feird, Sijiding to fhe Kevin Cmoln wlU probePiy folU" vlU vldty' 

echo -date- ^ i^evim doMin now hot hot been found, ©Ind to Tlie Kevin doiwin vlll probgiHy fpu," w AllmiiyAggfS/Af|Gywa(>in.ti4.iif-ai^ 

elte 

If [ tpJNS} - “hevinon«gi»gm,M«" ] li { m "Mtvlntwotbwln^oaii* Ji then 

oSQSCtliit -e "toy *lhe Kevin Uaoin new iseen fOMnd, Binding to Tha Kevin biMoin la nou atnrting,.* with vicky' 

ficho "LJutu- * - lha Kevin Qwilrt tm twen fiMul. SLrijLfig to lha Kavin Dcwlln La npu ttAtit^l.* AlhiWyAjDfik/JIht^A&dcIn^tdnM 

fl 
fl 
11 

dona 

fl; 


Figure 3. 



check for network 
connectivity. 

See figure 2 , 

Schoim: r see Vicki in here. 
Kevin: Yes. The problem 
we sometimes encountered 
wa.s that SI lech wtmld 
download an image, and 
relx>ot the Mac only to find 
the Mac was not on the 
network. Or, in certain 
cases, the Macs would 
unbind and we would have 
to re[>ind tliein. Either way, 
tfie script now checks for 
not just netw^ork 
conncx'tivity, i)uL if ilie Mac 
is connected to our 
network. It announces its 
findings using llie voice 
Vicki on die Mac. 'Fhis way 
our techs know whether 
tile machine is binding or 
nut. 

Schouii: Part of this script 
looks familiar. 

See figure 5. 

Kevin: [laughs] I lx>rrowed- 
and gave credit to-Mike 
Bombich as this is based on 
the script called, “Who .stole 
my Mac script”. It was 
important to us, to make 
sure our techs knew what 
die .status was, when they 
imaged a machine. Tliis 
helps us track binding 
is,sues, 

Schoun: Let’s talk aboyt 
the AD binding. 

Kevin: Sure. Before I run 
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9mti stjirt nyHrrct 

m iio*f Irt’t Sfft iJ>e eytuat ni»i 

i# ini* (BTt er tfifi icriisi it a wdiriwl of the togln^Jjyttostfix acript trot iMw,4}Qiih1ch.cn 

echo 7biiv'<li3^ ^ Setiirtt QyHcitt Ptrfa 9 ^ 

#» (tart ngc Mdma 

t«iiiMO<irwc-YibWircQr>f If} ene | out Vether/ ( 9siib(*:", '"')j print t2 

*« Get our default pLlat vqr 

HHtAiiW.mX}od^ 

» Change tNj User Tenpitite 

n Ettieto Old byilMt fi let oret q^upy over our default vm. 
m-H '/9yetai/LibraryAMr Teaploie^rigllth JprojA(hroi^/f>refer«K«/By^ 

Gp-H 'i;rsiwie«A(lsreii^^^*f^^ '/SyitaHAitffaryAtoer Teapt<rteAr«;hth JprojAibrory/Pfeferencftt/fyrtDtt' 

*$ Ch/ngp the User Teiplate Dtroctsrv 

cd /Sj«tahAlhr«rvA*aiBrV THpLate/EngUth^iprojAi&ran'/FreferBriDet/SyHcK 
n taonoH the rUet 

hyttoBiltms-'l« -A /S^te^^tlbrqry/iJserV T€ep|qte^ngUiih<lprojAi)»rory/ft'erenn»£^eyho$t 

for itea In SbyHoatltces 
do 

If [ ajhii $llM \ grefi *c $eiastarHV‘ -*!•]; then 
m iltai echo |tte» | sed '^is/togttertiif/trtwA^eEs/g''' 

t ft 


iS^DpiHit far loeel (oeal hidd^i Awin cni Coot, utiicfi im dlaobLflci 

b^ttoitdir* echo /UseraAOCALMWIN 

tiefKj /van/root 

echo /var/htddemdetn 

for lt«w in tthrttovtdir 
do 

ra -ft ttteHAlhrory^/I^Hvicea^/^^ 

cp -H /Syetei^lbRBT/AnG/Bisttawt/ fitessAlbFaiYvT^ervioetAtytloflt 

cd SiltoeeAlbrai^yi’iirferancn/ByHoet 
bj^fostlten-: la ^ tttfiB3A.tdroryfCTererBnGes/&^tf(»t 
fear itea in |b)4iDatUMB 
do 

If [ echo tfteii I grep -p fecaterW - *t* ]l then 
mi tltee etho tlte* | led "s/l*d&terH*4h»AddroH/g'^ 
tl 


the actual bind, 1 set 
all die parameters. 
This part of the 
script seLs the 
paramcicrs. 

See figure 4. 

Schouii: 1 see the 
uuidgen command 
in there! 1 should 
explain to our 
readers chat 
uuidgen is a 
command that 
creates a unique 
ID, unique 

enough that the 
man page states, 
“Hie uuidgen 
command 
generates a 

Universally 
Unique Idenrifier 
(UUID), a 128d>it 
value guaranteed 
to be unique. A 
UUIO is made 
unique over both 
space and time by 
combining a value unique to the compyter 
on which it was genenited—usyally the 
hthernet hardware address—and a value 
representing the nuinlrer of 100-nanosecond 
intervals, since October 15, 1582 at 00:00:00," 
You gotta love Apple code writers 
someiiines. “Unique over space AND time" 
lla. 

Kevin: Well, the issue is that if a Mac 
liinds to an AD domain, the AD domain 
cannot use that computer name to bind 
more than iwice. So, if a computer's name 
is already in the AD domain, and our techs 
re-iniage it, the bind fails. Using a portion 
of the uuidgen output insures us a unique 
ID vviili which to bind the Mac, 

Schoun: 1 also see that you did not put the 
password into this script for the actual bind, 
Thai you are calling the output of an 
AppleScript file. Why? 

Kevin: Seairity. This way the script calls the 
AppleSi ript file and it returns the password. 
Just a little more secure this way, 

Schoun: So with all the varial)les set, now the 
bind? 

Kevin: Yes. Again we used the dsconfigad 


Figure 6. 
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71S I i* Verify ttirtt vo ittu mw biMid 
Ilf [cj[»oar«t’((i4:conf1sod -sJnw 1 tmnd ^y 

2ii iTaKBvxiaa’{flKi3r^\^ -ffw I art^ "CSfl^Xitftr teccunt* I ci*. '(print $1}')' 

Jifj 

Ha| if [ n^xSDuraf- * 

211 i ViDU ore nrt twtnf to ^iwe Diractory:' ]; then 

212: echo Vhln/ikite - filMDfNC FAfLED^ ife ore not eurrently hcwMJ to Active DireCta7.>»:/LtbTi(iiyAiiiB/^M/ill0J^in.|4at;e,lO0 

:c»iiEcriipt ^ *sciy ‘Binding Foiled. You ore net QurrenfLly bound to Active Dtractwy. You vill need to ItanudlLy seuv Directory ServlDn” 
224 I ei» 

2fS \ edw Vhifv'diJUi ‘ - tto oana Mow botmd to Active Directory with ID ‘${rk3HSounc^* AliiiriiryAriaVAfl^AMQin.l^o.log 

m j D^&cTipi -0 'wy ‘Vqu ora rm Oovnci to Active Direotmy" with vicicy' 

ur exit 

»B fi 

129 

210 I 

111 { Of Mov m dfllerte the AD bind ocript, possnonl sKript ord lonthd tta to tint it doem^t run ogntn by dceidaft and i 
IJi ; see •ta‘ ^ AiDFivy/LJ3gt/AliG/AD3eln4 

Jlliir* *jOyftwt/L ibraTyAiM ' i Pi JNMiom/coa .oeg. atnoon .pi tft‘ » AibtwyAoge/AM^ADJDin^tdau^lDg 
234 HXB‘^AifaroryAJigirAlindEM/ilDP.Kot^ » AibraryAogs/AnC/AOAiin.filiate. Logi 

2n 

iih 
197 
?3J 


I with thn blrdlng. 


*# Kill the loginvindow to fore* a nee login with the AD, 
Atsr/bifi/ltll lal I logldwifKlpu 
aait ft 


Figure 7. 


Vital Stats 


) 


Years in rr industry : 6 

Information: Kevin is in eimr^^e of the image creation and 
deployment for Conde Nasi, 

Computers: About 2700 Macs, 42 Xserves, 4 Xserve RAlDs, 
Windows Active Directory Seiv/ers, wireless networks. 

Programming LanguagesiSheil Scrij>ting. AppleScript 


command iine tooi for that. We of courxse write to the iog 
file, check for an oider edu.mit.Kerberos Hie and get rid of 
it, if one exists, and set the search policies. 

See figure 5. 

Schoun: t see a sleep coniniand in there, 

Kevin: h seetried to go smoother wlien we did this. 
Schoun: llien the ByHo,si i,Hsucs? Wliy the problem? 

Kevin: As you know, ByHost fiJes are MAC addne.ss specific^ 
so we have lliem set the way we want, llten we put all Xs in 
the place of the addres.s, Wt^ then copy tliese and replac:e ilie 
Xs with the Itxai Mac's MAC adtlress. We do litis for tile 
template for any user’s that log in via AD, our local 
administrator account, and a iiidden account we have. 

See figure 6. 

Schoun: And the last part of liie script? 

Kevin: Checking die hind, iiaving Vicki ncXify the tech, and liten 
deleting the launciid itetn, the AppleScript file widi die 
password, and tlien deleting itself, killing die loginwinclow 
process and iiaving it cx>me Ixick. Tliis way, die AD user oan log 
in and get a newly created home tblder, wiih all die customized 
tweaks we've added in the user template, such tweiiks to the 
.GlcjlialPreferences file, the Dtxk, die menu liar, the screen saver, 


die liackgroond, and 
so on. 

See figure 7. 

Schoun: Tills is in 
incredibly powerful 
saipt. Again r see 
some of Mike’s 
work in here, but 
you have done a 
nice job of pulling 
it all together. 
Kevin: Thanks, 

Our next step is to 
take this and make 

a humchd item that watches the bind and if it fails, it deletes 
the /library/Preferences/edy.init.Kerberos file, the 
DirecloryServices direck>ry inside of the same lt)cation, and 
pulls them from a Itidden location on the local disk and 
rebinds the machine automatically. 

Schoun: I w^Duld also suggest, you use the mail command to 
email an administralor account, when this occurs. In this 
way, your techs can be a bit more prtyactive than reactive. 
Tliey will know when a mad line unbinds. 

Kevin: Yea. We want to do more with laiinchd and scripts. 
Schoun: Kevin, this is all we have time for, liut 1 know^ you 
iiave more to say about your setup. 1 think this script is an 
excellent place to start, ll gives tiie reader a clear- cut way of 
implementing this type of bind. Td like to talk to you more 
alxHit iunv this interacts with the Netinfo database and 
wluii other tweaks you've df)ne to ilie system. 

Kevin: Be happy to. We are very confident in our 
process, and have moved to cut down time to under 5 
minutes, if possible. 

Schoun: 1 think our readers wall lie excited to learn aLiout 
w'hat else you liave done. 

Nofe: Kevhi has muit 
infrastructure (xut this time 
script itself 


more io say about his 
/ wanted focus on the 


Jit I 
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